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 포함)

추가 정보

IDispatch