estrutura KS_VIDEOINFOHEADER (ksmedia.h)

A estrutura KS_VIDEOINFOHEADER descreve as informações de bitmap e cor de um fluxo de vídeo.

Sintaxe

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

Membros

rcSource

Especifica um retângulo de recorte que seleciona a parte do sinal de vídeo ativo a ser usado.

rcTarget

Especifica um retângulo que define a janela de vídeo de destino.

dwBitRate

Especifica um valor que indica a taxa de dados aproximada do fluxo de vídeo, em bits por segundo.

dwBitErrorRate

Especifica um valor que indica a taxa de erros de dados do fluxo de vídeo, em erros de bits por segundo.

AvgTimePerFrame

Especifica o tempo médio por quadro, em unidades de 100 nanossegundos.

bmiHeader

Descreve uma estrutura KS_BITMAPINFOHEADER que contém informações de cor e dimensão sobre o bitmap da imagem de vídeo.

Comentários

Para descrever um fluxo de vídeo com configurações bob ou weave, use KS_VIDEOINFOHEADER2.

A estrutura KS_VIDEOINFOHEADER é idêntica à estrutura VIDEOINFOHEADER do Microsoft DirectShow.

Um filtro de origem pode solicitar que o filtro do coletor use apenas uma seção do vídeo fornecendo valores que definem efetivamente um retângulo de recorte no membro rcSource . No entanto, se o filtro do coletor não marcar para o retângulo de recorte na conexão, o filtro de coletor simplesmente renderiza todo o vídeo, ignorando efetivamente todas as informações de recorte passadas do filtro de origem para o filtro de coletor.

O ideal é que um filtro de coletor verifique rcSource e, se o filtro de coletor não der suporte à extração de imagem e o retângulo não estiver vazio, ele rejeitará a conexão. Um filtro deve usar a função Do Win32 SetRectEmpty para redefinir um retângulo para todos os zeros (e definir IsRectEmpty como posteriormente marcar retângulo).

O membro rcTarget especifica o retângulo de destino para o vídeo. A maioria dos filtros de origem define esse membro como todos os zeros. Um filtro downstream pode solicitar que o vídeo seja colocado em uma área específica dos buffers que ele fornece. Nesse caso, ele chama a função Win32 QueryAccept com um destino não vazio.

Requisitos

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

Confira também

KS_BITMAPINFOHEADER

KS_VIDEOINFOHEADER2