CreateMediaType function

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The CreateMediaType function allocates a new AM_MEDIA_TYPE structure, including the format block.

Syntax

AM_MEDIA_TYPE* WINAPI CreateMediaType(
   AM_MEDIA_TYPE const *pSrc
);

Parameters

pSrc

Pointer to an AM_MEDIA_TYPE structure. The method copies this structure into the new structure.

Return value

Returns a new AM_MEDIA_TYPE structure, or NULL if there is an error.

Remarks

To free the memory allocated by this function, call DeleteMediaType.

Requirements

See also

Media Type Functions