Método CBaseControlVideo.GetVideoPaletteEntries

[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.]

O GetVideoPaletteEntries método recupera um intervalo de entradas de paleta para o vídeo.

Sintaxe

HRESULT GetVideoPaletteEntries(
   long StartIndex,
   long Entries,
   long *pRetrieved,
   long *pPalette
);

Parâmetros

Startindex

Entrada da paleta inicial baseada em zero.

Entradas

Número de entradas necessárias.

pRetrieved

Ponteiro para o número de cores obtidas.

pPalette

Ponteiro para o buffer de saída para cores.

Retornar valor

Retorna NOERROR se tiver êxito, VFW_E_NO_PALETTE_AVAILABLE se os exemplos de vídeo não tiverem paleta de cores, E_OUTOFMEMORY se não houver memória suficiente disponível, E_INVALIDARG se StartIndex for inválido ou S_FALSE se não houver cores na paleta.

Comentários

Essa função membro retorna a paleta atual do vídeo como uma matriz alocada pelo usuário. Para permanecer consistente, use os membros na estrutura PALETTEENTRY do Win32 para retornar as cores, em vez dos membros na estrutura RGBQUAD (embora o parâmetro seja long). A memória é alocada pelo chamador, portanto, basta copiar cada um por sua vez. Determine se o número de entradas solicitadas e o deslocamento da posição inicial são válidos. Se o número de entradas for avaliado como zero, retornará um código S_FALSE.

Requisitos

Requisito	Valor
parâmetro	Ctlutil.h (inclua Streams.h)
Biblioteca	Strmbase.lib (builds de varejo); Strmbasd.lib (builds de depuração)

Confira também

Classe CBaseControlVideo