Compartir a través de

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

  • Artículo

[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 GetColorKey método recupera la clave de color que usa una secuencia de vídeo.

Sintaxis

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

Parámetros

[out] pColorKey

Puntero a una estructura COLORKEY que contiene el tipo de clave y un índice de paleta.

[out] pColor

Puntero a un valor que indica el índice de paleta de 8 bits del COLORKEY devuelto si el modo de visualización actual está pálido de 8 bits. De lo contrario, es un valor que representa la clave de color en el formato de píxel del modo de presentación actual.

Valor devuelto

Devuelve un valor HRESULT . Entre los valores posibles figuran los siguientes:

Código devuelto Descripción
E_INVALIDARG
 Argumentos no válidos, ambos parámetros son NULL.
E_FAIL
 GetColorKey no se pudo realizar porque no se conoce la clave de color.
NOERROR
 Correcto.

Observaciones

La obtención del valor en la secuencia principal recuperará la clave de color de destino que usa la superficie superpuesta. Al obtener este valor en el pin secundario, se devuelve la clave de color que usa esa secuencia en particular.

La implementación actual de DirectShow de esta interfaz puede devolver NULL para los parámetros pColorKey o pColor ; sin embargo, se producirá un error en el método y se devolverá E_INVALIDARG si ambos parámetros son NULL.

Nota El valor DWORD devuelto por el parámetro pColor es el color real que se usa. Por lo tanto, si la profundidad de bits de la pantalla es 8, 16, 24, 32 los últimos 8, 16, 24 o 32 bits del DWORD , especifique el valor real de la clave de color.
 

Requisitos

   
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 mpconfig.h
Library Strmiids.lib

Consulte también

Códigos de error y éxito

IMixerPinConfig (interfaz)

IMixerPinConfig::SetColorKey