estrutura KS_VIDEOINFO (ksmedia.h)

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

Sintaxe

typedef struct tagKS_VIDEOINFO {
  RECT                rcSource;
  RECT                rcTarget;
  DWORD               dwBitRate;
  DWORD               dwBitErrorRate;
  REFERENCE_TIME      AvgTimePerFrame;
  KS_BITMAPINFOHEADER bmiHeader;
  union {
    KS_RGBQUAD       bmiColors[KS_iPALETTE_COLORS];
    DWORD            dwBitMasks[KS_iMASK_COLORS];
    KS_TRUECOLORINFO TrueColorInfo;
  };
} KS_VIDEOINFO, *PKS_VIDEOINFO;

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 indica qual parte do buffer de destino usar.

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 erro 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.

bmiColors[KS_iPALETTE_COLORS]

Matriz de estruturas de KS_RGBQUAD que especifica a paleta de cores do vídeo. Cada estrutura representa uma única cor, que é uma combinação de intensidades vermelha, verde e azul.

dwBitMasks[KS_iMASK_COLORS]

Matriz de valores DWORD que especificam bitmasks de cor verdadeira.

TrueColorInfo

KS_TRUECOLORINFO estrutura que contém uma paleta de cores e uma matriz de máscaras de bits de cor.

Comentários

Essa estrutura não deve ser usada, a menos que o membro biSize do membro KS_BITMAPINFOHEADER esteja definido como sizeof(KS_BITMAPINFOHEADER).

Um filtro de origem pode solicitar que o filtro de 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 de 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 Win32 SetRectEmpty para redefinir um retângulo para todos os zeros (e IsRectEmpty para 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_RGBQUAD

KS_TRUECOLORINFO