MFInitVideoFormat 함수(mfapi.h)

[이 API는 지원되지 않으며 나중에 변경되거나 사용할 수 없습니다. 애플리케이션은 MFVIDEOFORMAT 구조를 사용하지 말고 미디어 형식 특성을 대신 사용해야 합니다. 자세한 내용은 비디오 미디어 형식을 참조하세요.]

DVD, 아날로그 텔레비전 또는 ATSC 디지털 텔레비전과 같은 표준 비디오 형식의 MFVIDEOFORMAT 구조를 초기화합니다.

구문

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

참고 항목

미디어 파운데이션 함수

미디어 유형

비디오 미디어 유형