estructura KS_VIDEOINFOHEADER (ksmedia.h)

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

Comentarios

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

La estructura de 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 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 del 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 está 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 en más adelante comprobar 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
Header	ksmedia.h (incluye Ksmedia.h)

Consulte también

KS_BITMAPINFOHEADER

KS_VIDEOINFOHEADER2