estructura KS_VIDEOINFO (ksmedia.h)

La estructura KS_VIDEOINFO describe la información de color y mapa de bits de una secuencia de vídeo.

Sintaxis

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;

Miembros

rcSource

Especifica un rectángulo de recorte que selecciona la parte de la señal de vídeo activa que se va a usar.

rcTarget

Especifica un rectángulo que indica qué parte del búfer de destino se va a usar.

dwBitRate

Especifica un valor que indica la velocidad de datos aproximada de la secuencia de vídeo, en bits por segundo.

dwBitErrorRate

Especifica un valor que indica la tasa de errores de datos de la secuencia de vídeo, en errores de bits por segundo.

AvgTimePerFrame

Especifica el tiempo medio por fotograma en unidades de 100 nanosegundos.

bmiHeader

Describe una estructura KS_BITMAPINFOHEADER que contiene información de color y dimensión sobre el mapa de bits de la imagen de vídeo.

bmiColors[KS_iPALETTE_COLORS]

Matriz de estructuras de KS_RGBQUAD que especifica la paleta de colores del vídeo. Cada estructura representa un único color, que es una combinación de densidades rojas, verdes y azules.

dwBitMasks[KS_iMASK_COLORS]

Matriz de valores DWORD que especifican máscaras de bits de color verdadero.

TrueColorInfo

KS_TRUECOLORINFO estructura que contiene una paleta de colores y una matriz de máscaras de bits de color.

Comentarios

Esta estructura no se debe usar a menos que el miembro biSize del miembro KS_BITMAPINFOHEADER esté establecido en sizeof(KS_BITMAPINFOHEADER).

Un filtro de origen puede solicitar que el filtro receptor tome solo una sección del vídeo proporcionando valores que definan eficazmente un rectángulo de recorte en el miembro rcSource . Sin embargo, si el filtro receptor no comprueba el rectángulo de recorte en la conexión, el filtro receptor simplemente representa todo el vídeo, ignorando eficazmente cualquier información de recorte que se pasa desde el filtro de origen al filtro receptor.

Idealmente, un filtro receptor comprueba rcSource y si el filtro receptor no admite la extracción de imágenes y el rectángulo no está vacío, rechaza la conexión. Un filtro debe usar la función Win32 SetRectEmpty para restablecer un rectángulo a todos los ceros (e IsRectEmpty para comprobar posteriormente el rectángulo).

El miembro rcTarget especifica el rectángulo de destino del vídeo. La mayoría de los filtros de origen establecen este miembro en todos los ceros. Un filtro de bajada puede solicitar que el vídeo se coloque en un área determinada de los búferes que suministra. En este caso, llama a la función Win32 QueryAccept con un destino no vacío.

Requisitos

Requisito	Valor
Header	ksmedia.h (incluya Ksmedia.h)

Consulte también

KS_BITMAPINFOHEADER

KS_RGBQUAD

KS_TRUECOLORINFO