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) |