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++.