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