IVideoWindow 인터페이스(control.h)
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드가 DirectShow 대신 Media Foundation에서 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
인터페이스는 IVideoWindow 비디오 창에서 속성을 설정합니다. 애플리케이션은 이를 사용하여 창 소유자, 창의 위치 및 차원 및 기타 속성을 설정할 수 있습니다.
IVideoWindow선호됩니다. 자세한 내용은 창 없는 모드 사용을 참조하세요.대부분의 경우 애플리케이션은 방금 설명한 메시징 문제로 인해 필터를 직접 호출하지 않고 이 인터페이스에 대해 Filter Graph Manager를 쿼리해야 합니다. 그러나 필터 그래프에 둘 이상의 Video Renderer가 있는 경우 필터 Graph 관리자는 임의로 선택된 비디오 렌더러 중 하나만 통신합니다. 따라서 애플리케이션에서 여러 비디오 창을 사용하는 경우 필터에서 IVideoWindow 직접 인터페이스를 사용합니다. 이 경우 IVideoWindow::NotifyOwnerMessage 메서드를 사용하여 각 Video Renderer instance 창 메시지를 전달해야 합니다.
다시 칠하는 동안 비디오 창이 깜박이지 않도록 하려면 WM_ERASEBKGND 메시지에 대한 기본 처리를 재정의하고 창을 지우지 마세요. (MFC 애플리케이션의 경우 빈 처리기로 CWnd::OnEraseBkgnd 를 재정의합니다.)
비디오 렌더러에 설정된 속성은 연속 연결과 연결 끊김 사이에 유지됩니다.
이 인터페이스는 Automation과 호환되므로 모든 부울 값은 OAFALSE(0) 및 OATRUE(–1)로 정의됩니다.
오류 코드: 비디오 렌더러 필터가 다른 필터에 연결되지 않은 경우 모든 메서드는 오류 코드 VFW_E_NOT_CONNECTED 반환합니다. Filter Graph Manager 구현의 경우 그래프에 비디오 렌더러 필터가 포함되어 있지 않으면 모든 메서드가 E_NOINTERFACE 반환합니다. 필터 그래프 관리자는 그래프에 비디오 렌더러가 없는 경우에도 인터페이스를 노출하므로 애플리케이션은 그래프를 빌드하기 전에 인터페이스를 쿼리할 수 있습니다.
필터 개발자: CBaseVideoWindow 클래스를 사용하여 이 인터페이스를 구현할 수 있습니다.
상속
IVideoWindow 인터페이스는 IDispatch 인터페이스에서 상속됩니다. IVideoWindow 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
IVideoWindow 인터페이스에는 이러한 메서드가 있습니다.
| IVideoWindow::get_AutoShow get_AutoShow 메서드는 비디오 렌더러가 비디오 데이터를 받을 때 비디오 창을 자동으로 표시하는지 여부를 쿼리합니다. |
| IVideoWindow::get_BackgroundPalette get_BackgroundPalette 메서드는 비디오 창이 배경에서 색상표를 실현하는지 여부를 쿼리합니다. |
| IVideoWindow::get_BorderColor get_BorderColor 메서드는 대상 사각형의 가장자리 주위에 나타나는 색을 검색합니다. |
| IVideoWindow::get_Caption get_Caption 메서드는 비디오 창 캡션 검색합니다. |
| IVideoWindow::get_FullScreenMode get_FullScreenMode 메서드는 비디오 렌더러가 전체 화면 모드인지 여부를 쿼리합니다. |
| IVideoWindow::get_Height get_Height 메서드는 비디오 창의 높이를 검색합니다. |
| IVideoWindow::get_Left get_Left 메서드는 비디오 창의 x축 좌표를 검색합니다. |
| IVideoWindow::get_MessageDrain get_MessageDrain 메서드는 비디오 창에서 마우스 및 키보드 메시지를 받는 창(있는 경우)을 검색합니다. |
| IVideoWindow::get_Owner get_Owner 메서드는 비디오 창의 부모 창(있는 경우)을 검색합니다. |
| IVideoWindow::get_Top get_Top 메서드는 비디오 창의 y 좌표를 검색합니다. |
| IVideoWindow::get_Visible get_Visible 메서드는 비디오 창이 표시되는지 여부를 쿼리합니다. |
| IVideoWindow::get_Width get_Width 메서드는 비디오 창의 너비를 검색합니다. |
| IVideoWindow::get_WindowState get_WindowState 메서드는 비디오 창이 표시, 숨김, 최소화 또는 최대화되었는지 여부를 쿼리합니다. |
| IVideoWindow::get_WindowStyle get_WindowStyle 메서드는 비디오 창에서 창 스타일을 검색합니다. |
| IVideoWindow::get_WindowStyleEx get_WindowStyleEx 메서드는 비디오 창에서 확장된 창 스타일을 검색합니다. |
| IVideoWindow::GetMaxIdealImageSize GetMaxIdealImageSize 메서드는 비디오 이미지에 대한 최대 이상적인 이미지 크기를 검색합니다. |
| IVideoWindow::GetMinIdealImageSize GetMinIdealImageSize 메서드는 비디오 이미지에 이상적인 최소 크기를 검색합니다. |
| IVideoWindow::GetRestorePosition GetRestorePosition 메서드는 복원된 창 위치를 검색합니다. |
| IVideoWindow::GetWindowPosition GetWindowPosition 메서드는 비디오 창의 위치를 검색합니다. |
| IVideoWindow::HideCursor HideCursor 메서드는 마우스가 비디오 창 위에 배치될 때 커서를 표시하거나 숨깁니다. |
| IVideoWindow::IsCursorHidden IsCursorHidden 메서드는 커서가 숨겨져 있는지 여부를 쿼리합니다. |
| IVideoWindow::NotifyOwnerMessage NotifyOwnerMessage 메서드는 비디오 창에 메시지를 전달합니다. |
| IVideoWindow::p ut_AutoShow put_AutoShow 메서드는 비디오 렌더러가 비디오 데이터를 받을 때 비디오 창을 자동으로 표시할지 여부를 지정합니다. |
| IVideoWindow::p ut_BackgroundPalette put_BackgroundPalette 메서드는 비디오 창이 배경에서 색상표를 실현하는지 여부를 지정합니다. |
| IVideoWindow::p ut_BorderColor put_BorderColor 메서드는 대상 사각형의 가장자리 주위에 표시되는 색을 설정합니다. |
| IVideoWindow::p ut_Caption put_Caption 메서드는 비디오 창을 캡션 설정합니다. |
| IVideoWindow::p ut_FullScreenMode put_FullScreenMode 메서드는 전체 화면 비디오 렌더링을 사용하거나 사용하지 않도록 설정합니다. |
| IVideoWindow::p ut_Height put_Height 메서드는 비디오 창의 높이를 설정합니다. |
| IVideoWindow::p ut_Left put_Left 메서드는 비디오 창의 x 좌표를 설정합니다. |
| IVideoWindow::p ut_MessageDrain put_MessageDrain 메서드는 비디오 창에서 마우스 및 키보드 메시지를 받을 창을 지정합니다. |
| IVideoWindow::p ut_Owner put_Owner 메서드는 비디오 창의 부모 창을 지정합니다. |
| IVideoWindow::p ut_Top put_Top 메서드는 비디오 창의 y 좌표를 지정합니다. |
| IVideoWindow::p ut_Visible put_Visible 메서드는 비디오 창을 표시하거나 숨깁니다. |
| IVideoWindow::p ut_Width put_Width 메서드는 비디오 창의 너비를 지정합니다. |
| IVideoWindow::p ut_WindowState put_WindowState 메서드는 비디오 창을 표시, 숨기기, 최소화 또는 최대화합니다. |
| IVideoWindow::p ut_WindowStyle put_WindowStyle 메서드는 비디오 창에서 창 스타일을 설정합니다. |
| IVideoWindow::p ut_WindowStyleEx put_WindowStyleEx 메서드는 비디오 창에서 확장 창 스타일을 설정합니다. |
| IVideoWindow::SetWindowForeground SetWindowForeground 메서드는 비디오 창을 Z 순서의 맨 위에 배치합니다. |
| IVideoWindow::SetWindowPosition SetWindowPosition 메서드는 비디오 창의 위치를 설정합니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | control.h(Dshow.h 포함) |