IGraphBuilder::SetLogFile

  • Article

This method sets the file into which actions taken in attempting to perform an operation are logged.

HRESULT SetLogFile(
  HANDLE hFile
);

Parameters

  • hFile
    [in] Handle to the log file.

Return Values

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

DirectShow applications and DirectShow filters have different include file and link library requirements. See Setting Up the Build Environment for more information.

OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.

See Also

IGraphBuilder Interface

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.