KS_DATARANGE_VIDEO estrutura (ksmedia.h)

Artigo
02/07/2025

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

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 definidos como VERDADEIRO.

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.

Observações

A estrutura KS_DATARANGE_VIDEO é usada para duas finalidades relacionadas:

No momento da inicialização do minidriver, o minidriver retorna uma matriz de estruturas de KS_DATARANGE_VIDEO expondo todos os formatos com suporte para um determinado pino, incluindo possíveis opções de corte e dimensionamento.
Quando um formato específico é selecionado por um cliente de 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 KS_DATAFORMAT_VIDEO.

Requisitos

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

Consulte também

KSDATARANGE

KS_VIDEOINFOHEADER

KS_VIDEO_STREAM_CONFIG_CAPS

Compartilhar via