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