Método IOverlay::SetColorKey (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na 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 Captura de Áudio/Vídeo no 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 SetColorKey método altera a chave de cor.

Sintaxe

HRESULT SetColorKey(
  [in, out] COLORKEY *pColorKey
);

Parâmetros

[in, out] pColorKey

Ponteiro para o valor da chave de cor a ser definido. Se tiver êxito, o valor real da chave de cor selecionado será copiado para esse parâmetro.

Retornar valor

Retorna S_OK se tiver êxito, E_POINTER se pColorKey for NULL ou E_INVALIDARG se o valor de pColorKey for inválido para a paleta atual ou formato de pixel.

Comentários

Se você alterar a chave de cor usando o SetColorKey método , todos os links de aconselhamento receberão um método de retorno de chamada IOverlayNotify::OnColorKeyChange com a nova cor.

Ao usar IOverlay::Advise em uma exibição palettizada, um filtro pode instalar uma chave de cor (usando SetColorKey) ou instalar uma paleta (usando IOverlay::SetPalette), mas não ambos. Isso ocorre porque as teclas de cor nesse modo exigem que uma paleta seja percebida que entraria em conflito com SetPalette. As teclas de cor podem ser desinstaladas solicitando uma chave de cor com o sinalizador CK_NOCOLORKEY. Da mesma forma, qualquer paleta instalada por meio de SetPalette pode ser desinstalada chamando SetPalette e passando parâmetros NULL (ou seja, SetPalette(0,NULL)).

Tentar definir uma paleta quando uma chave de cor é instalada retorna um erro VFW_E_PALETTE_SET. Tentar definir uma chave de cor quando uma paleta é instalada retorna VFW_E_COLOR_KEY_SET.

Requisitos

Confira também

Códigos de erro e êxito

IOverlay Interface