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 |
---|---|
|
Argumentos inválidos, ambos os parâmetros são NULL. |
|
GetColorKey falha porque a chave de cor não é conhecida.
|
|
Ê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.
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 |