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

另请参阅

媒体基础函数

媒体类型

未压缩的视频媒体类型

视频媒体类型