VIDEO_ZOOM_RECT 특성

  • 아티클

EVR( Enhanced Video Renderer )의 비디오 믹서에 대한 원본 사각형을 지정합니다. 원본 사각형은 믹서가 대상 표면에 비추는 비디오 프레임의 부분입니다.

데이터 형식

바이트 배열

설명

이 특성의 값은 MFVideoNormalizedRect 구조체입니다.

원본 사각형은 전체 비디오 프레임이 {0, 0, 1, 1}좌표가 있는 사각형을 차지하는 정규화된 좌표계를 기준으로 정의됩니다. 원본 사각형은 비디오 프레임 내에 맞아야 합니다. 원본 사각형의 좌표 범위는 (0...1)입니다.

표준 EVR 발표자는 믹서에서 이 특성을 설정합니다. 특성을 설정하려면 다음을 수행합니다.

  1. 믹서에서 IMFTransform::GetAttributes 를 호출하여 믹서의 특성 저장소를 가져옵니다.
  2. IMFAttributes::SetBlob을 호출하여 믹서에서 VIDEO_ZOOM_RECT 특성을 설정합니다. 값은 MFVideoNormalizedRect 구조체입니다.

사용자 지정 EVR 발표자에서 이 특성을 사용하여 IMFVideoDisplayControl::SetVideoPosition 메서드를 구현할 수 있습니다. 자세한 내용은 원본 및 대상 사각형을 참조하세요.

이 특성의 GUID 상수는 strmiids.lib에서 내보냅니다.

예제

다음 예제에서는 믹서에서 원본 사각형을 설정합니다.

HRESULT SetMixerSourceRect(IMFTransform *pMixer, const MFVideoNormalizedRect& nrcSource)
{
    if (pMixer == NULL)
    {
        return E_POINTER;
    }

    IMFAttributes *pAttributes = NULL;

    HRESULT hr = pMixer->GetAttributes(&pAttributes);
    if (SUCCEEDED(hr))
    {
        hr = pAttributes->SetBlob(VIDEO_ZOOM_RECT, (const UINT8*)&nrcSource, sizeof(nrcSource));
        pAttributes->Release();
    }
    return hr;
}

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2008 [데스크톱 앱만 해당]
헤더
Evr.h

추가 정보

미디어 파운데이션 특성의 사전순 목록

향상된 비디오 렌더러 특성

EVR 발표자를 작성하는 방법

IMFAttributes::GetBlob

IMFAttributes::SetBlob