CMediaType.SetFormat 方法

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

方法 SetFormat 初始化格式块。

语法

BOOL SetFormat(
   BYTE  *pFormat,
   ULONG length
);

参数

pFormat

指向包含格式块的内存块的指针。

length

格式块的长度(以字节为单位)。

返回值

如果成功,则返回 TRUE ;如果发生错误,则返回 FALSE

备注

此方法为格式块分配内存,并将 pFormat 指定的缓冲区复制到新的格式块中。 如果媒体类型已包含格式块,则会释放旧格式块。 方法还设置 AM_MEDIA_TYPE 结构的 cbFormat 成员。

若要设置格式类型,请调用 CMediaType::SetFormatType 方法。

要求

要求
标头
Mtype.h (包括 Streams.h)

Strmbase.lib (零售版本) ;
Strmbasd.lib (调试生成)

另请参阅

CMediaType 类