IltmmMediaInfo::ResetSource

#include "ltmm.h"

C Syntax

HRESULT IltmmMediaInfo_ResetSource (pMediaInfo)

C++ Syntax

HRESULT ResetSource ()

 

IltmmMediaInfo *pMediaInfo;

/* pointer to an interface */

Resets the media source to none. This removes the current media source reference from the IltmmMediaInfo interface/object.

Parameter

Description

pMediaInfo

Pointer to an IltmmMediaInfo Interface.

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

Call IltmmMediaInfo::ResetSource to release the source file when it is no longer needed.

The current source media file, set using IltmmMediaInfo::put_SourceFile, is the file for which the IltmmMediaInfo interface/object gets information. This function must be called before calling any of the other IltmmMediaInfo function used for retrieving information.

To get the current source media file, call IltmmMediaInfo::get_SourceFile.

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:

IltmmMediaInfo interface, IltmmMediaInfo::get_SourceFile, IltmmMediaInfo::put_SourceFile,  IltmmMediaInfo::get_SourceFilter, IltmmMediaInfo::get_SourceFilterClassID, IltmmMediaInfo::get_SourceFilterDispatch, IltmmMediaInfo::get_SourceMediaType, IltmmMediaInfo::get_SourceFormat, IltmmMediaInfo::get_SourceFormatName

Topics:

Multimedia Function Group
Media File Information

Example

For a C example, refer to Retrieving Media File Information for C.

For a C++ example, refer to Retrieving Media File Information for C++.