Metodo IMixerPinConfig::GetColorKey (mpconfig.h)

Articolo
07/28/2023

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetColorKey metodo recupera la chiave di colore utilizzata da un flusso video.

Sintassi

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

Parametri

[out] pColorKey

Puntatore a una struttura COLORKEY che contiene il tipo di chiave e un indice della tavolozza.

[out] pColor

Puntatore a un valore che indica l'indice della tavolozza a 8 bit di COLORKEY restituito se la modalità di visualizzazione corrente è pallido a 8 bit. In caso contrario, è un valore che rappresenta la chiave di colore nel formato pixel della modalità di visualizzazione corrente.

Valore restituito

Restituisce un valore HRESULT . I possibili valori sono i seguenti:

Codice restituito	Descrizione
E_INVALIDARG	Gli argomenti non validi, entrambi i parametri sono NULL.
E_FAIL	`GetColorKey` non è riuscito perché la chiave di colore non è nota.
NOERROR	Operazione completata.

Commenti

Ottenere il valore nel flusso primario recupererà la chiave del colore di destinazione usata dalla superficie di sovrapposizione. Il recupero di questo valore sul pin secondario restituisce la chiave di colore utilizzata da tale flusso specifico.

L'implementazione corrente di DirectShow di questa interfaccia può restituire NULL per i parametri pColorKey o pColor ; Tuttavia, il metodo avrà esito negativo e restituirà E_INVALIDARG se entrambi i parametri sono NULL.

Nota Il valore DWORD restituito dal parametro pColor è il colore effettivo utilizzato. Pertanto, se la profondità di bit dello schermo è 8, 16, 24, 32 gli ultimi 8, 16, 24 o 32 bit della DWORD specificano il valore effettivo della chiave di colore.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mpconfig.h
Libreria	Strmiids.lib

Vedi anche

Codici di errore e di esito positivo

Interfaccia IMixerPinConfig

IMixerPinConfig::SetColorKey

Condividi tramite