CBaseControlVideo 클래스

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

CBaseControlVideo 클래스는 IBasicVideo 인터페이스를 구현하고 일반 비디오 창의 비디오 속성을 제어합니다. 일반적으로 CBaseControlVideo 개체는 디스플레이의 창에 비디오를 그리는 비디오 렌더러입니다.

많은 CBaseControlVideo 멤버 함수는 비디오 렌더러가 필터 그래프에 연결되어야 합니다. 연결되지 않은 경우 멤버 함수는 VFW_E_NOT_CONNECTED 반환합니다. 비디오 렌더러에 설정된 속성은 연속 연결과 연결 끊김 사이에 유지됩니다. 모든 애플리케이션은 프레젠테이션을 시작하기 전에 렌더러 속성을 다시 설정해야 합니다.

비디오로 작업할 때 애플리케이션은 사용할 비디오의 일부를 선택할 수 있습니다. 이 부분은 CBaseControlVideo 개체가 제어하는 원본 사각형입니다. CBaseControlVideo 를 사용하면 애플리케이션에서 원본 사각형을 설정하고 검색할 수 있습니다. CBaseControlVideo에서 사용하는 모든 사각형은 오른쪽 및 아래쪽 값이 아닌 너비 및 높이 값을 사용합니다. 원본 사각형이 설정되지 않은 경우 원본 사각형의 속성은 전체 네이티브 비디오 크기를 반환합니다.

보호된 데이터 멤버	Description
m_pFilter	소유 미디어 필터에 대한 포인터입니다.
m_pInterfaceLock	외부에서 정의된 중요 섹션입니다.
m_pPin	연결에 대한 미디어 형식을 제어합니다.
멤버 함수	Description
CBaseControlVideo	CBaseControlVideo 개체를 생성합니다.
CopyImage	비디오 이미지의 메모리 복사본을 만듭니다.
GetImageSize	비디오 이미지 크기 정보를 검색합니다.
SetControlVideoPin	이 개체가 동기화되어야 하는 핀을 설정합니다.
재정의 가능한 멤버 함수	Description
CheckSourceRect	원본 사각형이 유효한지 여부를 확인합니다.
CheckTargetRect	대상 사각형이 유효한지 여부를 확인합니다.
GetSourceRect	현재 원본 비디오 사각형(순수 가상)을 검색합니다.
GetStaticImage	메모리 버퍼(순수 가상)의 현재 이미지를 반환합니다.
GetTargetRect	현재 대상 비디오 사각형(순수 가상)을 검색합니다.
GetVideoFormat	비디오 형식을 포함하는 VIDEOINFOHEADER 구조를 검색합니다.
IsDefaultSourceRect	렌더러가 기본 원본 사각형(순수 가상)을 사용하는지 여부를 확인합니다.
IsDefaultTargetRect	렌더러가 기본 대상 사각형(순수 가상)을 사용하는지 확인합니다.
OnUpdateRectangles	원본 또는 대상 사각형이 변경되면 호출합니다.
OnVideoSizeChange	애플리케이션에 EC_VIDEO_SIZE_CHANGED 전달합니다.
SetDefaultSourceRect	기본 원본 비디오 사각형(순수 가상)을 설정합니다.
SetDefaultTargetRect	기본 대상 비디오 사각형(순수 가상)을 설정합니다.
SetSourceRect	현재 원본 비디오 사각형(순수 가상)을 설정합니다.
SetTargetRect	현재 대상 사각형(순수 가상)을 설정합니다.
IBasicVideo 메서드	Description
get_AvgTimePerFrame	프레임당 대략적인 평균 시간을 검색합니다.
get_BitErrorRate	대략적인 비트 오류율을 검색합니다.
get_BitRate	비디오에 대한 대략적인 비트 속도를 검색합니다.
GetCurrentImage	현재 이미지의 메모리 렌더링을 검색합니다.
get_DestinationHeight	현재 대상 사각형의 높이를 검색합니다.
get_DestinationLeft	현재 대상 사각형의 왼쪽 좌표를 검색합니다.
GetDestinationPosition	현재 대상 위치를 검색합니다.
get_DestinationTop	현재 대상 사각형의 위쪽 좌표를 검색합니다.
get_DestinationWidth	현재 대상 사각형의 너비를 검색합니다.
get_SourceHeight	현재 원본 사각형의 높이를 검색합니다.
get_SourceLeft	현재 원본 사각형의 왼쪽 좌표를 검색합니다.
GetSourcePosition	현재 원본 위치를 검색합니다.
get_SourceTop	현재 원본 사각형의 위쪽 좌표를 검색합니다.
get_SourceWidth	현재 원본 사각형의 너비를 검색합니다.
get_VideoHeight	네이티브 비디오 높이를 검색합니다.
GetVideoPaletteEntries	비디오에 대한 색상표 항목의 범위를 검색합니다.
GetVideoSize	네이티브 비디오의 너비와 높이를 검색합니다.
get_VideoWidth	네이티브 비디오 너비를 검색합니다.
IsUsingDefaultDestination	렌더러가 기본 대상 창을 사용하고 있는지 확인합니다.
IsUsingDefaultSource	렌더러가 기본 원본 창을 사용하는지 여부를 확인합니다.
put_DestinationHeight	대상 사각형의 높이를 설정합니다.
put_DestinationLeft	대상 사각형의 왼쪽 좌표를 설정합니다.
put_DestinationTop	대상 사각형의 위쪽 좌표를 설정합니다.
put_DestinationWidth	대상 사각형의 너비를 설정합니다.
put_SourceHeight	원본 사각형의 높이를 설정합니다.
put_SourceLeft	원본 사각형의 왼쪽 좌표를 설정합니다.
put_SourceTop	원본 사각형의 위쪽 좌표를 설정합니다.
put_SourceWidth	원본 사각형의 너비를 설정합니다.
SetDefaultDestinationPosition	기본 대상 위치를 다시 설정합니다.
SetDefaultSourcePosition	기본 원본 위치를 다시 설정합니다.
SetDestinationPosition	대상 사각형 위치를 설정합니다.
SetSourcePosition	원본 사각형 위치를 설정합니다.

 

추가 정보

DirectShow 기본 클래스