IltmmConvert::OpenLogFile

#include "ltmm.h"

C Syntax

HRESULT IltmmConvert_OpenLogFile(pConvert, filename, flags)

C++ Syntax

HRESULT OpenLogFile(filename, flags)

 

IltmmConvert *pConvert;

/* pointer to an interface */

BSTR filename;

/* log file name */

long flags;

/* logging flags */

Initializes a text file for logging conversion operations data.

Parameter

Description

pConvert

Pointer to an IltmmConvert interface.

filename

A character string that contains the name of the file in which to save the logging information.

flags

Value that represents the desired logging options. For a list of possible values, refer to ltmmLogFile_Flag Constants.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

Use the IltmmConvert::OpenLogFile function to initialize a file to log data about conversion operations. Use the ltmmConvert::CloseLogFile function to stop logging data to the file and close the file.

If the passed file name to the filename parameter is NULL, then the function will return an error.

If the passed file name to the filename parameter currently exists, and the ltmmLogFile_Append flag has not been passed to flags parameter, then the existing file will be overwritten.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Elements:

IltmmConvert::CloseLogFile

Topics:

Multimedia Function Group

Example

For a C example, refer to IltmmConvert::get_EnableStillCapture

For a C++ example, refer to IltmmConvert::get_EnableStillCapture