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:

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.

Requisitos

Confira também

Códigos de erro e êxito

IMixerPinConfig Interface

IMixerPinConfig::SetColorKey