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