MFInitVideoFormat_RGB 函数 (mfapi.h)

[此 API 不受支持,将来可能会更改或不可用。 应用程序应避免使用 MFVIDEOFORMAT 结构,而应改用媒体类型属性。 有关详细信息,请参阅 视频媒体类型。]

为未压缩的 RGB 视频格式初始化 MFVIDEOFORMAT 结构。

语法

HRESULT MFInitVideoFormat_RGB(
  [in] MFVIDEOFORMAT *pVideoFormat,
  [in] DWORD         dwWidth,
  [in] DWORD         dwHeight,
  [in] DWORD         D3Dfmt
);

参数

[in] pVideoFormat

指向 MFVIDEOFORMAT 结构的指针。 函数使用格式信息填充结构成员。

[in] dwWidth

视频的宽度(以像素为单位)。

[in] dwHeight

视频的高度(以像素为单位)。

[in] D3Dfmt

指定 RGB 格式 的D3DFORMAT 值。

返回值

如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此函数为指定的 RGB 格式填充一些合理的默认值。

建议开发人员使用媒体类型属性,而不是使用 MFVIDEOFORMAT 结构。 请参阅 媒体类型属性

通常,应避免调用此函数。 如果知道所有格式详细信息,则可以填充 MFVIDEOFORMAT 结构,而无需使用此函数。 如果不知道所有格式详细信息,则属性优于使用 MFVIDEOFORMAT 结构。

注意 在 Windows 7 之前,此函数是从 evr.dll 导出的。 从 Windows 7 开始,此函数从 mfplat.dll 导出,evr.dll 导出调用 mfplat.dll 的存根函数。 有关详细信息,请参阅 Windows 7 中的库更改
 

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 mfapi.h
Library Evr.lib
DLL Mfplat.dll

另请参阅

媒体基础函数

媒体类型

未压缩的视频媒体类型

视频媒体类型