KS_VIDEOINFO estrutura (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 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.
bmiColors[KS_iPALETTE_COLORS]
Matriz de estruturas 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 máscaras de bits de cor verdadeira.
TrueColorInfo
KS_TRUECOLORINFO estrutura que contém uma paleta de cores e uma matriz de máscaras de bits de cor.
Observações
Essa estrutura não deve ser usada a menos que o biSize membro do membro KS_BITMAPINFOHEADER esteja definido como tamanhos de(KS_BITMAPINFOHEADER).
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 verificar o retângulo de recorte na conexão, o filtro do coletor simplesmente renderizará todo o vídeo, ignorando efetivamente todas as informações de recorte passadas do filtro de origem para o filtro do coletor.
Idealmente, um filtro de coletor verifica rcSource e se o filtro do coletor não dá suporte à extração de imagem e o retângulo não vazio, ele rejeita a conexão. Um filtro deve usar a função Win32 SetRectEmpty para redefinir um retângulo para todos os zeros (e IsRectEmpty para verificar posteriormente o 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 fornecidos por ele. Nesse caso, ele chama a função Win32 queryAccept com um destino não limitado.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | ksmedia.h (inclua Ksmedia.h) |