IBasicVideo 인터페이스(control.h)
[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]
인터페이스는 IBasicVideo 대상 및 원본 사각형과 같은 비디오 속성을 설정합니다. Video Renderer 필터 및 비디오 혼합 렌더러 필터는 이 인터페이스를 구현하지만 인터페이스는 필터 그래프 관리자를 통해 애플리케이션에 노출됩니다. 애플리케이션은 항상 Filter Graph Manager에서 이 인터페이스를 검색해야 합니다.
인터페이스는 IBasicVideo 비디오 이미지와 연결된 다음 사각형을 조작합니다.
- 원본 사각형은 표시되는 원본 이미지의 부분입니다.
- 대상 사각형은 원본 사각형을 수신하는 비디오 창의 부분입니다.
- 비디오 사각형은 원래 비디오 이미지입니다.
Video Renderer에 설정된 속성은 연속 연결과 연결 끊김 사이에 유지됩니다.
오류 코드: 비디오 렌더러 필터가 다른 필터에 연결되지 않은 경우 모든 메서드는 오류 코드 VFW_E_NOT_CONNECTED 반환합니다. Filter Graph Manager 구현의 경우 그래프에 비디오 렌더러 필터가 포함되어 있지 않으면 모든 메서드가 E_NOINTERFACE 반환합니다. 필터 그래프 관리자는 그래프에 비디오 렌더러가 없는 경우에도 인터페이스를 노출하므로 애플리케이션은 그래프를 빌드하기 전에 인터페이스를 쿼리할 수 있습니다.
상속
IBasicVideo 인터페이스는 IDispatch 인터페이스에서 상속됩니다. IBasicVideo 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
IBasicVideo 인터페이스에는 이러한 메서드가 있습니다.
| IBasicVideo::get_AvgTimePerFrame get_AvgTimePerFrame 메서드는 연속 프레임 간의 평균 시간을 검색합니다. |
| IBasicVideo::get_BitErrorRate get_BitErrorRate 메서드는 비디오 스트림의 대략적인 비트 오류 속도를 검색합니다. |
| IBasicVideo::get_BitRate get_BitRate 메서드는 비디오 스트림의 대략적인 비트 속도를 검색합니다. |
| IBasicVideo::get_DestinationHeight get_DestinationHeight 메서드는 대상 사각형의 높이를 검색합니다. |
| IBasicVideo::get_DestinationLeft get_DestinationLeft 메서드는 대상 사각형의 x 좌표를 검색합니다. |
| IBasicVideo::get_DestinationTop get_DestinationTop 메서드는 대상 사각형의 y 좌표를 검색합니다. |
| IBasicVideo::get_DestinationWidth get_DestinationWidth 메서드는 대상 사각형의 너비를 검색합니다. |
| IBasicVideo::get_SourceHeight get_SourceHeight 메서드는 원본 사각형의 높이를 검색합니다. |
| IBasicVideo::get_SourceLeft get_SourceLeft 메서드는 원본 사각형의 x 좌표를 검색합니다. |
| IBasicVideo::get_SourceTop get_SourceTop 메서드는 원본 사각형의 y 좌표를 검색합니다. |
| IBasicVideo::get_SourceWidth get_SourceWidth 메서드는 원본 사각형의 너비를 검색합니다. |
| IBasicVideo::get_VideoHeight get_VideoHeight 메서드는 비디오의 네이티브 높이를 검색합니다. |
| IBasicVideo::get_VideoWidth get_VideoWidth 메서드는 비디오의 네이티브 너비를 검색합니다. |
| IBasicVideo::GetCurrentImage GetCurrentImage 메서드는 렌더러에서 대기 중인 현재 이미지를 검색합니다. |
| IBasicVideo::GetDestinationPosition GetDestinationPosition 메서드는 대상 사각형의 위치를 검색합니다. |
| IBasicVideo::GetSourcePosition GetSourcePosition 메서드는 원본 사각형의 위치를 검색합니다. |
| IBasicVideo::GetVideoPaletteEntries GetVideoPaletteEntries 메서드는 비디오의 색상표 색을 검색합니다. |
| IBasicVideo::GetVideoSize GetVideoSize 메서드는 네이티브 비디오 차원을 검색합니다. |
| IBasicVideo::IsUsingDefaultDestination IsUsingDefaultDestination 메서드는 렌더러가 기본 대상 사각형을 사용하고 있는지 여부를 쿼리합니다. |
| IBasicVideo::IsUsingDefaultSource IsUsingDefaultSource 메서드는 렌더러가 기본 원본 사각형을 사용하고 있는지 여부를 쿼리합니다. |
| IBasicVideo::p ut_DestinationHeight put_DestinationHeight 메서드는 대상 사각형의 높이를 설정합니다. |
| IBasicVideo::p ut_DestinationLeft put_DestinationLeft 메서드는 대상 사각형의 x 좌표를 설정합니다. |
| IBasicVideo::p ut_DestinationTop put_DestinationTop 메서드는 대상 사각형의 y 좌표를 설정합니다. |
| IBasicVideo::p ut_DestinationWidth put_DestinationWidth 메서드는 대상 사각형의 너비를 설정합니다. |
| IBasicVideo::p ut_SourceHeight put_SourceHeight 메서드는 원본 사각형의 높이를 설정합니다. |
| IBasicVideo::p ut_SourceLeft put_SourceLeft 메서드는 원본 사각형의 x 좌표를 설정합니다. |
| IBasicVideo::p ut_SourceTop put_SourceTop 메서드는 원본 사각형의 y 좌표를 설정합니다. |
| IBasicVideo::p ut_SourceWidth put_SourceWidth 메서드는 원본 사각형의 너비를 설정합니다. |
| IBasicVideo::SetDefaultDestinationPosition SetDefaultDestinationPosition 메서드는 기본 대상 사각형으로 되돌아갑니다. 이 메서드가 호출되면 비디오 렌더러는 전체 창을 사용하여 재생합니다. |
| IBasicVideo::SetDefaultSourcePosition SetDefaultSourcePosition 메서드는 기본 원본 사각형으로 되돌아갑니다. 이 메서드가 호출되면 비디오 렌더러는 자르지 않고 전체 비디오 이미지를 사용합니다. |
| IBasicVideo::SetDestinationPosition SetDestinationPosition 메서드는 대상 사각형을 설정합니다. |
| IBasicVideo::SetSourcePosition SetSourcePosition 메서드는 원본 사각형을 설정합니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | control.h(Dshow.h 포함) |