MFInitVideoFormat 函式 (mfapi.h)

[此 API 不受支援，未來可能會變更或無法使用。 應用程式應該避免使用 MFVIDEOFORMAT 結構，並改用媒體類型屬性。 如需詳細資訊，請參閱 影片媒體類型。]

初始化標準視訊格式的 MFVIDEOFORMAT 結構，例如 DVD、類比電視或 ATSC 數位電視。

語法

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

參數

[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
程式庫	Evr.lib
Dll	Mfplat.dll

另請參閱

媒體基礎函式

媒體類型

視訊媒體類型