CreateAudioMediaType 函数

  • 项目

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

CreateAudioMediaType 函数从 WAVEFORMATEX 结构初始化媒体类型。

语法

HRESULT STDAPI CreateAudioMediaType(
   const WAVEFORMATEX  *pwfx,
         AM_MEDIA_TYPE *pmt,
         BOOL          bSetFormat
);

参数

pwfx

指向提供的 WAVEFORMATEX 结构的指针。

Pmt

指向要初始化 AM_MEDIA_TYPE 结构的指针。

bSetFormat

指示是否初始化格式块的标志。 指定 TRUE 初始化它，否则指定 FALSE 。

返回值

如果无法为格式数据分配内存，则返回E_OUTOFMEMORY;否则S_OK。

备注

如果 bSetFormat 参数为 TRUE，则方法为格式块分配内存。 如果 pmt 参数已包含分配的格式块，则会发生内存泄漏。 若要避免内存泄漏，请在调用此函数之前调用 FreeMediaType 。 方法返回后，再次调用 FreeMediaType 以释放格式块。

要求

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

另请参阅

媒体类型函数