CBaseControlVideo.IsDefaultSourceRect 메서드

  • 아티클

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

메서드는 IsDefaultSourceRect 렌더러가 기본 원본 사각형(순수 가상)을 사용하는지 여부를 결정합니다.

구문

virtual HRESULT IsDefaultSourceRect() = 0;

매개 변수

이 메서드에는 매개 변수가 없습니다.

반환 값

렌더러가 기본 원본을 사용하는 경우 S_OK 반환합니다. 그렇지 않으면 는 S_FALSE 반환합니다.

설명

이 멤버 함수는 파생 클래스에서 구현되어야 합니다. CBaseControlVideo::IsUsingDefaultSource 멤버 함수에 의해 호출됩니다.

다음 예제에서는 파생 클래스에서 이 함수의 구현을 보여 줍니다.

// Return S_OK if using the default source; otherwise, S_FALSE.
HRESULT CVideoText::IsDefaultSourceRect()
{
    RECT SourceRect;

    VIDEOINFO *pVideoInfo = (VIDEOINFO *) m_pRenderer->m_mtIn.Format();
    BITMAPINFOHEADER *pHeader = HEADER(pVideoInfo);
    m_pRenderer->m_DrawImage.GetSourceRect(&SourceRect);

    // Check the coordinates that match the video dimensions.

    if (SourceRect.left != 0 || SourceRect.top != 0 ||
            SourceRect.right != pHeader->biWidth ||
                SourceRect.bottom != pHeader->biHeight) {
                    return S_FALSE;
    }
    return S_OK;
}

이 예제에서 CVideoText는 CBaseControlVideo에서 파생된 클래스이며, m_pRenderer CBaseVideoRenderer에서 파생된 클래스의 개체를 보유하며 파생 클래스에 정의된 m_DrawImage 데이터 멤버는 CDrawImage 개체를 보유합니다. 파생 클래스에도 정의된 m_mtIn 데이터 멤버는 입력 핀의 미디어 형식이 있는 CMediaType 개체를 보유합니다.

요구 사항

요구 사항 값
헤더
Ctlutil.h(Streams.h 포함)
라이브러리
Strmbase.lib(소매 빌드);
Strmbasd.lib(디버그 빌드)

추가 정보

CBaseControlVideo 클래스