Compartir a través de


estructura KS_VIDEOINFOHEADER (ksmedia.h)

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

Sintaxis

typedef struct tagKS_VIDEOINFOHEADER {
  RECT                rcSource;
  RECT                rcTarget;
  DWORD               dwBitRate;
  DWORD               dwBitErrorRate;
  REFERENCE_TIME      AvgTimePerFrame;
  KS_BITMAPINFOHEADER bmiHeader;
} KS_VIDEOINFOHEADER, *PKS_VIDEOINFOHEADER;

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 define la ventana de vídeo de destino de destino.

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 de KS_BITMAPINFOHEADER que contiene información de color y dimensión sobre el mapa de bits de la imagen de vídeo.

Observaciones

Para describir una secuencia de vídeo con la configuración bob o weave, use KS_VIDEOINFOHEADER2.

La estructura KS_VIDEOINFOHEADER es idéntica a la estructura VIDEOINFOHEADER de Microsoft DirectShow.

Un filtro de origen puede solicitar que el filtro receptor tome solo una sección del vídeo proporcionando valores que definen 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.

Lo ideal es que un filtro receptor compruebe rcSource y si el filtro receptor no admite la extracción de imágenes y el rectángulo no se vacío, rechaza la conexión. Un filtro debe usar la función Win32 SetRectEmpty para restablecer un rectángulo en todos los ceros (y establecer 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 proporciona. En este caso, llama a la función Win32 QueryAccept con un destino no vacío.

Requisitos

Requisito Valor
encabezado de ksmedia.h (incluya Ksmedia.h)

Consulte también

KS_BITMAPINFOHEADER

KS_VIDEOINFOHEADER2