DirectShow DirectShow 레퍼런스 인터페이스 IOverlay Advise [목차열람] [주소복사] [슬롯비우기] |
Microsoft DirectX 9.0 |
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 를 사용한다.
참조