IGraphBuilder::SetLogFile

  • Article
 
Microsoft DirectShow 9.0

IGraphBuilder::SetLogFile

The SetLogFile method sets the file for logging actions taken when attempting to perform an operation.

Syntax

  HRESULT SetLogFile(
  DWORD_PTR hFile
);

Parameters

hFile

Handle to the log file.

Return Values

Returns S_OK.

Remarks

This method is for use in debugging; it is intended to help you determine the cause of any failure to automatically build a filter graph.

The hFile parameter must be an open file handle. Your application is responsible for opening the file and for closing it when you are done logging. Before closing the file handle, call SetLogFile with a NULL file handle. This will ensure that the component does not attempt to use the file handle after you have closed it.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also