通过

CopyMediaType 函数

  • 项目

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

CopyMediaType 函数将AM_MEDIA_TYPE结构复制到另一个结构，包括格式块

语法

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

参数

pmtTarget

指向 AM_MEDIA_TYPE 结构的指针。 方法将媒体类型复制到此结构中。

pmtSource

指向要复制 的源AM_MEDIA_TYPE 结构的指针。

返回值

返回S_OK或E_OUTOFMEMORY。

备注

此函数为格式块分配内存。 如果 pmtTarget 参数已包含分配的格式块，则会发生内存泄漏。 若要避免内存泄漏，请在调用此函数之前调用 FreeMediaType 。

方法返回后，在 pmtTarget 上调用 FreeMediaType 以释放格式块。

要求

要求 值
标头
Mtype.h (包括 Streams.h)
库
Strmbase.lib (零售版本) ;
Strmbasd.lib (调试生成)

另请参阅

媒体类型函数