DirectShow DirectShow 레퍼런스 인터페이스 IOverlay Advise   [목차열람] [주소복사] [슬롯비우기]
IOverlay::Advise
 
Microsoft DirectX 9.0

IOverlay::Advise

Advise 메서드는,dwInterests 인수로 지정된 오버레이 이벤트용의 아드바이즈린크를 설정한다.

구문

HRESULT Advise(
  IOverlayNotify *pOverlayNotify,
  DWORD dwInterests
);

파라미터

pOverlayNotify

[in] 통지 인터페이스의 포인터.

dwInterests

[in] 목적의 콜백. 이하의 이벤트로부터 완성되는 임의의 서브 세트를 지정한다.

이벤트 설명
ADVISE_NONE 변경 없음.
ADVISE_CLIPPING 클립 영역의 변경 (윈도우와 동기 한다).
ADVISE_PALETTE 팔레트의 변경.
ADVISE_COLORKEY chroma-key값의 변경.
ADVISE_POSITION 비디오 윈도우의 위치의 변경 (윈도우와 동기 하지 않는다).
ADVISE_DISPLAY_CHANGE WM_DISPLAYCHANGE 에 관한 호출. 디스플레이 해상도를 변경 하면, 모든 윈도우에 WM_DISPLAYCHANGE 메시지가 보내진다.
ADVISE_ALL2 위에의 모든 이벤트.

반환값

성공했을 경우는 S_OK 를 돌려준다. 실패했을 경우는 HRESULT 에러 코드를 돌려준다.

주의

이 메서드는,IOverlayNotify 인터페이스가 통지를 받기 위한 아드바이즈린크를 설정한다. 이러한 이벤트중 한쪽이 발생 하면,pOverlayNotify 인수에게 건네진 적절한 엔트리 포인트가 호출된다 (IOverlayNotify::OnClipChange ,IOverlayNotify::OnColorKeyChange ,IOverlayNotify::OnPaletteChange , 또는 IOverlayNotify::OnPositionChange ).

1 개의 IOverlay 인터페이스로 설정할 수 있는 아드바이즈린크는 1 개 뿐이다. 2 번째 이후의 호출로 다른 통지 인터페이스를 설정하려고 하면 VFW_E_ADVISE_ALREADY_SET 가 반환된다. 아드바이즈린크를 취소하려면 ,IOverlay::Unadvise 를 사용한다.

참조

↑TOP