IGraphBuilder::SetLogFile
A version of this page is also available for
4/8/2010
This method sets the file into which actions taken in attempting to perform an operation are logged.
Syntax
HRESULT SetLogFile(
HANDLE hFile
);
Parameters
- hFile
[in] Handle to the log file.
Return Value
Returns an HRESULT value that depends on the implementation. HRESULT can be one of the following standard constants, or other values not listed.
| Value | Description |
|---|---|
E_FAIL |
Failure. |
E_POINTER |
Null pointer argument. |
E_INVALIDARG |
Invalid argument. |
E_NOTIMPL |
Method is not supported. |
S_OK or NOERROR |
Success. |
Remarks
Note to OEMs: To enable logging with IGraphBuilder::SetLogFile, you must set SYSGEN_DSHOW_ERRORS when building your platform.
The hFile parameter must be an open file handle. After calling this method with a valid file handle, actions taken by IGraphBuilder methods when attempting to build a filter graph are logged to this file. This is intended to help you determine the cause of any failure to automatically build a filter graph.
Requirements
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Windows CE 2.12 requires DXPAK 1.0 or later |