Compartilhar via


Método IMixerPinConfig::GetColorKey (mpconfig.h)

[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 GetColorKey método recupera a chave de cor que está sendo usada por um fluxo de vídeo.

Sintaxe

HRESULT GetColorKey(
  [out] COLORKEY *pColorKey,
  [out] DWORD    *pColor
);

Parâmetros

[out] pColorKey

Ponteiro para uma estrutura COLORKEY que contém o tipo de chave e um índice de paleta.

[out] pColor

Ponteiro para um valor que indica o índice de paleta de 8 bits da COLORKEY retornado se o modo de exibição atual for palettizado de 8 bits. Caso contrário, é um valor que representa a chave de cor no formato de pixel do modo de exibição atual.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes:

Código de retorno Descrição
E_INVALIDARG
Argumentos inválidos, ambos os parâmetros são NULL.
E_FAIL
GetColorKey falha porque a chave de cor não é conhecida.
NOERROR
Êxito.

Comentários

Obter o valor no fluxo primário recuperará a chave de cor de destino que está sendo usada pela superfície de sobreposição. Obter esse valor no pino secundário retorna a chave de cor que está sendo usada por esse fluxo específico.

A implementação atual do DirectShow dessa interface pode retornar NULL para os parâmetros pColorKey ou pColor ; no entanto, o método falhará e retornará E_INVALIDARG se ambos os parâmetros forem NULL.

Nota O valor DWORD retornado pelo parâmetro pColor é a cor real que está sendo usada. Portanto, se a profundidade do bit da exibição for 8, 16, 24, 32 os últimos 8, 16, 24 ou 32 bits do DWORD especificarão o valor real da chave de cor.
 

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mpconfig.h
Biblioteca Strmiids.lib

Confira também

Códigos de erro e êxito

IMixerPinConfig Interface

IMixerPinConfig::SetColorKey