IOverlay 인터페이스(strmif.h)

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

인터페이스는 IOverlay 올바른 창 위치에 비디오를 배치하는 동안 필터가 비디오 메모리에 직접 쓸 수 있도록 정보를 제공합니다. 비디오 렌더러의 입력 핀에 구현되며 해당 필터의 IOverlayNotify 메서드를 호출하여 비디오 창의 변경 내용을 알리는 업스트림 필터(일반적으로 비디오 압축 해제기)와 통신합니다.

이 인터페이스는 DirectDraw® 오버레이 기능과 아무런 관계가 없습니다. Microsoft 비디오 렌더러는 사용 가능한 경우 DirectDraw 오버레이를 사용하여 IMemInputPin 인터페이스를 통해 수신하는 데이터를 그립니다. IMemInputPin 대신 사용되는 이 인터페이스는 렌더러의 그리기 기능을 우회하지만 다른 표시 속성에 대한 알림이 필요한 모든 업스트림 필터에 대한 알림 지원을 제공하기 위한 것입니다.

및 IOverlayNotify 인터페이스가 함께 작동하는 방법에 IOverlay 대한 자세한 내용은 IOverlayNotify 참조 페이지를 참조하세요.

렌더링 창의 변경 내용에 대한 비동기 알림에 대한 자세한 내용은 IOverlayNotify2 인터페이스를 참조하세요.

이 인터페이스는 Microsoft® DirectShow® 비디오 렌더러 필터에서 구현됩니다. 원하는 경우 대체 비디오 렌더러 필터에서 구현할 수도 있습니다. 이렇게 하는 경우 프레임 버퍼에 직접 쓰거나 오버레이를 배치하려고 하면 비디오를 표시할 위치를 알 수 있도록 이 인터페이스를 구현합니다. 이 인터페이스를 구현하려면 비디오 속성 변경 알림과 함께 그리기를 수행하는 필터의 IOverlayNotify 인터페이스 또는 IOverlayNotify2 인터페이스에서 메서드를 사용하도록 렌더러가 준비되어야 합니다.

DirectShow의 창 기반 렌더러는 IMemInputPin 및 IOverlay 인터페이스를 모두 지원합니다. 이러한 두 인터페이스는 상호 배타적입니다. 필터는 연결 중에 하위 형식의 MEDIASUBTYPE_Overlay 미디어 형식을 제공하여 IOverlay 전송을 사용하도록 선택합니다. 연결 후에는 인터페이스를 성공적으로 가져와 사용할 IOverlay 수 있습니다. 다른 비디오 형식(예: MEDIASUBTYPE_RGB8)과 연결되면 를 통해 IOverlay 를 호출하려고 하면 VFW_E_NOT_OVERLAY_CONNECTION 반환됩니다.

비디오 오버레이 속성을 제어하고 비디오 데이터 자체의 표시를 처리하려는 업스트림 필터에서 이 함수의 메서드를 사용합니다. 일반적으로 비디오 하드웨어에 대한 대체 연결이 있는 하드웨어 비디오 디코더에서 사용됩니다.

상속

IOverlay 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IOverlay 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IOverlay 인터페이스에는 이러한 메서드가 있습니다.

IOverlay::Advise Advise 메서드는 dwInterests 매개 변수로 지정된 오버레이 이벤트에 대한 advise 링크를 설정합니다.
IOverlay::GetClipList GetClipList 메서드는 클리핑 목록을 검색합니다.
IOverlay::GetColorKey GetColorKey 메서드는 크로마 키에 사용되는 현재 색 키를 검색합니다.
IOverlay::GetDefaultColorKey GetDefaultColorKey 메서드는 chroma 키 오버레이에 사용되는 기본 색 키를 검색합니다.
IOverlay::GetPalette GetPalette 메서드는 현재 시스템 팔레트를 검색합니다.
IOverlay::GetVideoPosition GetVideoPosition 메서드는 현재 비디오 원본 및 대상 사각형을 검색합니다.
IOverlay::GetWindowHandle GetWindowHandle 메서드는 현재 창 핸들을 검색합니다.
IOverlay::SetColorKey SetColorKey 메서드는 색 키를 변경합니다.
IOverlay::SetPalette SetPalette 메서드는 팔레트를 설정합니다.
IOverlay::Unadvise Unadvise 메서드는 IOverlayNotify 인터페이스로 설정된 advise 링크를 종료합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	strmif.h(Dshow.h 포함)