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