IltmmMediaTypeDisp::ResetMediaType

#include "ltmm.h"

C Syntax	HRESULT IltmmMediaType_ResetMediaType(pMediaTypeDisp)
C++ Syntax	HRESULT ResetMediaType()

IltmmMediaTypeDisp *pMediaTypeDisp;

/* pointer to an interface */

Clears and frees the all the media type settings.

Parameter	Description
pMediaTypeDisp	Pointer to an IltmmMediaTypeDisp 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

This method allows you to reset the whole media type (format buffer, type, subtype, etc). All the values set through any IltmmMediaTypeDisp::put_xxx properties are reset to defaults.

You would typically call this method if you want to start building the media type all over without freeing the existing interface and recreating a new one.

This method is implicitly called when you create a new instance of the IltmmMediaTypeDisp interface.

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.

Platforms

Win32, x64

See Also

Elements:	IltmmMediaTypeDisp::put_FixedSizeSamples, IltmmMediaTypeDisp::put_FormatSize, IltmmMediaTypeDisp::put_FormatType, IltmmMediaTypeDisp::put_SampleSize, IltmmMediaTypeDisp::put_Subtype, IltmmMediaTypeDisp::put_TemporalCompression, IltmmMediaTypeDisp::put_Type, IltmmMediaTypeDisp::ResetFormat, IltmmMediaTypeDisp::SetFormatData, IltmmMediaTypeDisp::SetPortableType
Topics:	Multimedia Function Group
	IltmmMediaTypeDisp interface
	ltmmMediaType object