DirectShow DirectShow 레퍼런스 인터페이스 IDDrawExclModeVideoCallback OnUpdateOverlay   [목차열람] [주소복사] [슬롯비우기]

IDDrawExclModeVideoCallback::OnUpdateOverlay

OnUpdateOverlay 메서드는, 비디오의 오버레이 표면이 표시되기 직전, 비표시가 되기 직전, 사이즈를 바꾸기 직전, 또는 위치를 바꾸기 직전에 애플리케이션에 통지해, 애플리케이션이 거기에 맞추어 윈도우를 재드로잉(Drawing) 할 수 있도록(듯이) 한다.

구문

HRESULT OnUpdateOverlay(
  BOOL bBeforeChange,
  DWORD dwFlags,
  BOOL bOldVisible,
  const RECT *prcSrcOld,
  const RECT *prcDestOld,
  BOOL bNewVisible,
  const RECT *prcSrcNew,
  const RECT *prcDestNew,
);

파라미터

bBeforeChange

[in] 호출이 오버레이에 관련하는 변경전에 행해지는지, 다음에 행해지는지를 나타내는 불형의 값. TRUE 는 전에 행해지는 것을 나타내, FALSE 는 다음에 행해지는 것을 나타낸다.

dwFlags

[in] 무엇이 바뀌는지, 또는 바뀌었는지를 나타내는 AM_OVERLAY_NOTIFY_FLAGS 열거의 값.

bOldVisible

[in] 구윈도우가 표시되고 있는지를 나타내는 불형의 값. TRUE 는 구윈도우가 표시되고 있는 것을 나타낸다.

prcSrcOld

[in] DirectDraw 표면의 낡은 소스의 위치를 나타내는 직사각형의 포인터.

prcDestOld

[in] 오버레이 표면내의 직사각형의 낡은 표시 위치를 나타내는 직사각형의 포인터.

bNewVisible

[in] 새로운 윈도우가 표시되고 있는지를 나타내는 불형의 값. TRUE 는 새로운 윈도우가 표시되고 있는 것을 나타낸다.

prcSrcNew

[in] DirectDraw 표면의 새로운 소스의 위치를 나타내는 직사각형의 포인터.

prcDestNew

[in] 오버레이 표면내의 직사각형의 새로운 표시 위치를 나타내는 직사각형의 포인터.

반환값

HRESULT 값을 돌려준다. 가능한 값은 다음과 같다.

주의

애플리케이션은, 오버레이에 관련하는 변경이 발생하기 전에 1 회, 발생한 후에 1 회, 이 메서드를 호출할 필요가 있다. 변경전에 행해지는 호출에서는, 애플리케이션이 이 메서드의 실행을 완료할 때까지 오버레이의 변경은 발생하지 않는다.

참조

• 에러 코드와 성공 코드
• IDDrawExclModeVideoCallback 인터페이스