CopyMediaType 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 CopyMediaType function copies an AM_MEDIA_TYPE structure into another structure, including the format block

Syntax

HRESULT WINAPI CopyMediaType(
         AM_MEDIA_TYPE *pmtTarget,
   const AM_MEDIA_TYPE *pmtSource
);

Parameters

pmtTarget

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

pmtSource

Pointer to a source AM_MEDIA_TYPE structure to copy.

Return value

Returns S_OK or E_OUTOFMEMORY.

Remarks

This function allocates the memory for the format block. If the pmtTarget parameter already contains an allocated format block, a memory leak will occur. To avoid a memory leak, call FreeMediaType before calling this function.

After the method returns, call FreeMediaType on pmtTarget to free the format block.

Requirements

See also

Media Type Functions