IOverlayNotify::OnPositionChange 메서드(strmif.h)

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

메서드는 OnPositionChange 위치가 변경되었다는 알림을 제공합니다.

구문

HRESULT OnPositionChange(
  [in] const RECT *pSourceRect,
  [in] const RECT *pDestinationRect
);

매개 변수

[in] pSourceRect

원본 비디오 사각형에 대한 포인터입니다.

[in] pDestinationRect

대상 비디오 사각형에 대한 포인터입니다. 표시되는 표시 영역에 잘리지 않습니다.

반환 값

성공하면 S_OK 반환합니다. 메서드가 실패하면 HRESULT 오류 코드가 반환됩니다.

설명

이 메서드는 동기 클리핑 업데이트의 비용을 원하지 않고 원본 또는 대상 비디오 위치가 변경되는 시기를 알고자 하는 하드웨어 오버레이 카드에서 사용하기 위한 콜백입니다.

IOverlayNotify::OnClipChange 메서드와 달리 이 메서드는 창 변경과의 동기화에서 호출되지 않고, 창이 변경된 후(기본적으로 WM_SIZE 메시지가 수신된 시간에) 특정 시점에 호출됩니다. 따라서 프레임 버퍼에 데이터를 인레이하지 않는 오버레이 카드에 적합합니다.

요구 사항

추가 정보

오류 및 성공 코드

IOverlayNotify 인터페이스