estructura KS_DATARANGE_VIDEO (ksmedia.h)

  • Artículo

La estructura de KS_DATARANGE_VIDEO describe una variedad de secuencias de vídeo sin bob o configuración de entrelazado.

Sintaxis

typedef struct tagKS_DATARANGE_VIDEO {
  KSDATARANGE                 DataRange;
  BOOL                        bFixedSizeSamples;
  BOOL                        bTemporalCompression;
  DWORD                       StreamDescriptionFlags;
  DWORD                       MemoryAllocationFlags;
  KS_VIDEO_STREAM_CONFIG_CAPS ConfigCaps;
  KS_VIDEOINFOHEADER          VideoInfoHeader;
} KS_DATARANGE_VIDEO, *PKS_DATARANGE_VIDEO;

Miembros

DataRange

Especifica el identificador principal para el formato.

bFixedSizeSamples

Especifica que todas las muestras tienen el mismo tamaño si se establece en TRUE.

bTemporalCompression

Especifica si cada muestra puede permanecer de forma independiente, sin depender de ejemplos anteriores o futuros.

StreamDescriptionFlags

Sin usar y debe establecerse en cero.

MemoryAllocationFlags

Sin usar y debe establecerse en cero.

ConfigCaps

Especifica la configuración de la secuencia, incluido el escalado, el recorte y las velocidades de datos y fotogramas.

VideoInfoHeader

Especifica los detalles de la secuencia de vídeo.

Comentarios

La estructura de KS_DATARANGE_VIDEO se usa con dos propósitos relacionados:

  1. En el tiempo de inicialización del minidriver, el minidriver devuelve una matriz de estructuras de KS_DATARANGE_VIDEO que exponen todos los formatos admitidos para un pin determinado, incluidas las posibles opciones de recorte y escalado.
  2. Cuando un cliente en modo de usuario selecciona un formato determinado, los miembros (y su configuración) de esta estructura determinan si el minidriver admite un formato propuesto. Los clientes en modo de usuario modifican el contenido del miembro VideoInfoHeader , pero deben dejar sin cambios todos los demás miembros de KS_DATARANGE_VIDEO. A continuación, el minidriver comprueba los parámetros solicitados y devuelve una estructura KS_DATAFORMAT_VIDEO. A continuación, el minidriver calcula los miembros que son únicos para el formato determinado solicitado.
Por ejemplo, una secuencia que admite formatos de captura RGB16, RGB24, YVU9 y JPEG define una matriz de cuatro estructuras KS_DATAFORMAT_VIDEO.

Requisitos

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

Consulte también

KSDATARANGE

KS_VIDEOINFOHEADER

KS_VIDEO_STREAM_CONFIG_CAPS