MFInitVideoFormat 函数 (mfapi.h)

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

初始化标准视频格式（如 DVD、模拟电视或 ATSC 数字电视）的 MFVIDEOFORMAT 结构。

语法

HRESULT MFInitVideoFormat(
  [out] MFVIDEOFORMAT         *pVideoFormat,
  [in]  MFStandardVideoFormat type
);

parameters

[out] pVideoFormat

指向 MFVIDEOFORMAT 结构的指针。 函数根据类型参数中指定的视频格式填充结构成员。

[in] type

视频格式，指定为 MFStandardVideoFormat 枚举的成员。

返回值

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

注解

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

 

示例

以下示例为标准视频格式创建媒体类型对象。

// Creates a media type for a standard video format.
HRESULT CreateStandardVideoMediaType(MFStandardVideoFormat type, IMFMediaType **ppMediaType)
{
    IMFMediaType *pMediaType = NULL;

    MFVIDEOFORMAT format;

    // Fill in the MFVIDEOFORMAT structure for the video format.
    HRESULT hr = MFInitVideoFormat(&format, type);
    if (FAILED(hr))
    {
        goto done;
    }

    // Create a new (empty) media type.
    hr = MFCreateMediaType(&pMediaType);
    if (FAILED(hr))
    {
        goto done;
    }

    // Initialize the media type from the MFVIDEOFORMAT structure.
    hr = MFInitMediaTypeFromMFVideoFormat(pMediaType, &format, sizeof(format));
    if (FAILED(hr))
    {
        goto done;
    }

    // Return the pointer to the caller.
    *ppMediaType = pMediaType;
    (*ppMediaType)->AddRef();

done:
    SafeRelease(&pMediaType);
    return hr;
}

要求

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

另请参阅

媒体基础函数

媒体类型

视频媒体类型