다음을 통해 공유


IBasicVideo 인터페이스(control.h)

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngineMedia 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