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

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El SetColorKey método cambia la clave de color.

Sintaxis

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

Parámetros

[in, out] pColorKey

Puntero al valor de clave de color que se va a establecer. Si se ejecuta correctamente, el valor de clave de color real seleccionado se copia en este parámetro.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente, E_POINTER si pColorKey es NULL o E_INVALIDARG si el valor de pColorKey no es válido para la paleta o el formato de píxeles actual.

Comentarios

Si cambia la clave de color mediante el SetColorKey método , todos los vínculos de aviso recibirán un método de devolución de llamada IOverlayNotify::OnColorKeyChange con el nuevo color.

Cuando se usa IOverlay::Advise en una pantalla palettized, un filtro puede instalar una clave de color (mediante SetColorKey) o instalar una paleta (mediante IOverlay::SetPalette), pero no ambas. Esto se debe a que las teclas de color de este modo requieren que se realice una paleta que entraría en conflicto con SetPalette. Las teclas de color se pueden desinstalar solicitando una clave de color con la marca CK_NOCOLORKEY. Del mismo modo, cualquier paleta instalada a través de SetPalette se puede desinstalar llamando a SetPalette y pasando parámetros NULL (es decir, SetPalette(0,NULL)).

Al intentar establecer una paleta cuando se instala una clave de color, se devuelve un error de VFW_E_PALETTE_SET. Al intentar establecer una clave de color cuando se instala una paleta, se devuelve VFW_E_COLOR_KEY_SET.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	strmif.h (incluya Dshow.h)
Library	Strmiids.lib

Consulte también

Códigos de error y éxito

IOverlay (interfaz)