Funções de vídeo e imagem

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

Essas funções e macros manipulam as estruturas de formato de vídeo directShow.

Função	Descrição
BIT_MASKS_MATCH	Compara as máscaras de cores para duas estruturas VIDEOINFO .
BITMASKS	Recupera as máscaras de cores de uma estrutura VIDEOINFO
CheckVideoInfoType	Verifica um tipo de mídia que contém uma estrutura de formato VIDEOINFOHEADER para erros que podem causar estouros de buffer ou estouros inteiros.
CheckVideoInfo2Type	Verifica um tipo de mídia que contém uma estrutura de formato VIDEOINFOHEADER2 para erros que podem causar estouros de buffer ou estouros inteiros.
CORES	Recupera as entradas de paleta de uma estrutura VIDEOINFO
ContainsPalette	Determina se uma estrutura VIDEOINFOHEADER especificada contém uma paleta.
ConvertVideoInfoToVideoInfo2	Converte um tipo de mídia que usa VIDEOINFOHEADER em um que usa VIDEOINFOHEADER2
DIBSIZE	Calcula o número de bytes exigidos por um DIB (bitmap independente do dispositivo).
GetBitCount	Retorna o número de bits por pixel usado por um subtipo de vídeo especificado.
GetBitmapFormatSize	Calcula o tamanho necessário para uma estrutura VIDEOINFO que pode conter uma estrutura BITMAPINFOHEADER especificada.
GetBitmapPalette	Retorna a primeira entrada de paleta em uma estrutura VIDEOINFOHEADER .
GetBitmapSize	Calcula o número de bytes exigidos por um DIB (bitmap independente do dispositivo).
GetBitmapSubtype	Retorna o GUID do subtipo de mídia para o bitmap especificado.
GetSubtypeName	Recupera o nome legível por humanos de um subtipo de vídeo.
GetTrueColorType	Retorna o GUID do subtipo de mídia para um bitmap RGB descompactado de 16 bits.
CABEÇALHO	Retorna o endereço do BITMAPINFOHEADER em um VIDEOINFOHEADER.
MPEG1_SEQUENCE_INFO	Retorna o endereço do cabeçalho de sequência dentro de uma estrutura MPEG1VIDEOINFO .
PALETTISED	Verifica se um bitmap tem uma profundidade de cor de 8 bits ou menos.
PALETTE_ENTRIES	Recupera o número máximo de cores na paleta de um bitmap especificado.
RESET_MASKS	Preenche os campos de máscara de cores em uma estrutura VIDEOINFO com zeros.
RESET_HEADER	Preenche um VIDEOINFOHEADER com zeros.
RESET_PALETTE	Preenche as entradas da paleta em uma estrutura VIDEOINFO com zeros.
SIZE_EGA_PALETTE	Calcula o tamanho necessário para as entradas de paleta em um bitmap RGB de 4 bits.
SIZE_MASKS	Calcula o tamanho das máscaras de cores em uma estrutura VIDEOINFO .
SIZE_MPEG1VIDEOINFO	Calcula o tamanho de uma estrutura MPEG1VIDEOINFO , incluindo o cabeçalho de sequência.
SIZE_PALETTE	calcula o tamanho das entradas de paleta em uma estrutura VIDEOINFO .
SIZE_PREHEADER	Calcula o deslocamento de bytes do campo bmiHeader dentro de uma estrutura VIDEOINFOHEADER .
SIZE_VIDEOHEADER	Calcula o tamanho da estrutura VIDEOINFOHEADER .
TRUECOLOR	Retorna a estrutura TRUECOLORINFO de uma estrutura VIDEOINFO .
ValidateBitmapInfoHeader	Verifica uma estrutura BITMAPINFOHEADER em busca de erros que possam causar estouros de buffer ou estouros inteiros.

 

Comentários

A maioria das macros e funções descritas na seção foram projetadas para manipular estruturas VIDEOINFOHEADER e VIDEOINFO para bitmaps RGB. Use essas macros com cuidado: a maioria delas pressupõe que a estrutura especificada foi inicializada corretamente. Muitos deles também pressupõem que a estrutura BITMAPINFOHEADER é o tamanho padrão; ou seja, biSize == sizeof(BITMAPINFOHEADER).

A biblioteca de classes base do DirectShow também fornece as seguintes constantes globais, que definem as máscaras de cores padrão para bitmaps de cor real.

Dados globais	Descrição
bits555	Matriz de máscaras de cores para um bitmap RGB de 16 bits no formato 5-5-5.
bits565	Matriz de máscaras de cores para um bitmap RGB de 16 bits no formato 5-6-5.
bits888	Matriz de máscaras de cores para um bitmap RGB de 24 bits.

 

Cada uma dessas constantes em uma matriz de três DWORDs, contendo as máscaras vermelha, verde e azul, nessa ordem.