estrutura KS_DATARANGE_VIDEO (ksmedia.h)

  • Artigo

A estrutura KS_DATARANGE_VIDEO descreve uma variedade de fluxos de vídeo sem configurações bob ou weave.

Sintaxe

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;

Membros

DataRange

Especifica o identificador principal para o formato.

bFixedSizeSamples

Especifica que todos os exemplos têm o mesmo tamanho se definido como TRUE.

bTemporalCompression

Especifica se cada exemplo pode ficar independentemente por conta própria, sem depender de exemplos anteriores ou futuros.

StreamDescriptionFlags

Não utilizado e deve ser definido como zero.

MemoryAllocationFlags

Não utilizado e deve ser definido como zero.

ConfigCaps

Especifica a configuração do fluxo, incluindo escala, corte e taxas de quadros e dados.

VideoInfoHeader

Especifica os detalhes do fluxo de vídeo.

Comentários

A estrutura KS_DATARANGE_VIDEO é usada para duas finalidades relacionadas:

  1. No momento da inicialização do minidriver, o minidriver retorna uma matriz de estruturas KS_DATARANGE_VIDEO expondo todos os formatos com suporte para um determinado pino, incluindo possíveis opções de corte e dimensionamento.
  2. Quando um formato específico é selecionado por um cliente do modo de usuário, os membros (e suas configurações) dessa estrutura determinam se um formato proposto é compatível com o minidriver. Os clientes do modo de usuário modificam o conteúdo do membro VideoInfoHeader , mas devem deixar todos os outros membros do KS_DATARANGE_VIDEO inalterados. Em seguida, o minidriver verifica os parâmetros solicitados e retorna uma estrutura KS_DATAFORMAT_VIDEO. Em seguida, o minidriver calcula os membros que são exclusivos para o formato específico solicitado.
Por exemplo, um fluxo que dá suporte a formatos de captura RGB16, RGB24, YVU9 e JPEG define uma matriz de quatro estruturas de KS_DATAFORMAT_VIDEO.

Requisitos

Requisito Valor
Cabeçalho ksmedia.h (inclua Ksmedia.h)

Confira também

KSDATARANGE

KS_VIDEOINFOHEADER

KS_VIDEO_STREAM_CONFIG_CAPS