KS_VIDEOINFO 구조체(ksmedia.h)

KS_VIDEOINFO 구조는 비디오 스트림의 비트맵 및 색 정보를 설명합니다.

구문

typedef struct tagKS_VIDEOINFO {
  RECT                rcSource;
  RECT                rcTarget;
  DWORD               dwBitRate;
  DWORD               dwBitErrorRate;
  REFERENCE_TIME      AvgTimePerFrame;
  KS_BITMAPINFOHEADER bmiHeader;
  union {
    KS_RGBQUAD       bmiColors[KS_iPALETTE_COLORS];
    DWORD            dwBitMasks[KS_iMASK_COLORS];
    KS_TRUECOLORINFO TrueColorInfo;
  };
} KS_VIDEOINFO, *PKS_VIDEOINFO;

멤버

rcSource

사용할 활성 비디오 신호의 부분을 선택하는 클리핑 사각형을 지정합니다.

rcTarget

사용할 대상 버퍼의 일부를 나타내는 사각형을 지정합니다.

dwBitRate

비디오 스트림의 대략적인 데이터 속도(초당 비트)를 나타내는 값을 지정합니다.

dwBitErrorRate

비디오 스트림의 데이터 오류율(초당 비트 오류)을 나타내는 값을 지정합니다.

AvgTimePerFrame

프레임당 평균 시간을 100나노초 단위로 지정합니다.

bmiHeader

비디오 이미지 비트맵에 대한 색 및 차원 정보를 포함하는 KS_BITMAPINFOHEADER 구조체에 대해 설명합니다.

bmiColors[KS_iPALETTE_COLORS]

비디오의 색상표를 지정하는 KS_RGBQUAD 구조체의 배열입니다. 각 구조체는 빨간색, 녹색 및 파란색 강도의 조합인 단일 색을 나타냅니다.

dwBitMasks[KS_iMASK_COLORS]

true 색 비트 마스크를 지정하는 DWORD 값의 배열입니다.

TrueColorInfo

색상 표와 색 비트 마스크 배열을 모두 포함하는 KS_TRUECOLORINFO 구조체입니다.

설명

KS_BITMAPINFOHEADER 멤버의 biSize 멤버가 sizeof(KS_BITMAPINFOHEADER)로 설정되지 않는 한 이 구조를 사용하면 안 됩니다.

원본 필터는 rcSource 멤버에서 클리핑 사각형을 효과적으로 정의하는 값을 제공하여 싱크 필터가 비디오의 섹션만 수행되도록 요청할 수 있습니다. 그러나 싱크 필터가 연결 시 클리핑 사각형에 대해 검사 않으면 싱크 필터는 모든 비디오를 렌더링하여 원본 필터에서 싱크 필터로 전달된 클리핑 정보를 효과적으로 무시합니다.

이상적으로 싱크 필터는 rcSource를 확인하고 싱크 필터가 이미지 추출을 지원하지 않고 사각형이 비어 있지 않으면 연결을 거부합니다. 필터는 Win32 함수 SetRectEmpty를 사용하여 사각형을 모든 0으로 다시 설정해야 합니다(나중에 직사각형을 검사 IsRectEmpty).

rcTarget 멤버는 비디오의 대상 사각형을 지정합니다. 대부분의 원본 필터는 이 멤버를 모두 0으로 설정합니다. 다운스트림 필터는 비디오가 제공하는 버퍼의 특정 영역에 배치되도록 요청할 수 있습니다. 이 경우 대상 없음을 사용하여 Win32 함수 QueryAccept 를 호출합니다.

요구 사항

요구 사항	값
헤더	ksmedia.h(Ksmedia.h 포함)

추가 정보

KS_BITMAPINFOHEADER

KS_RGBQUAD

KS_TRUECOLORINFO