Metodo IOverlay::GetDefaultColorKey (strmif.h)
[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.
Il GetDefaultColorKey metodo recupera la chiave di colore predefinita usata per una sovrapposizione di chiavi chroma.
Sintassi
HRESULT GetDefaultColorKey(
[out] COLORKEY *pColorKey
);
Parametri
[out] pColorKey
Puntatore a una variabile che riceve la chiave di colore predefinita.
Valore restituito
Restituisce S_OK se riuscito. Se il metodo ha esito negativo, restituisce un codice di errore HRESULT .
Commenti
Un filtro che usa chiavi di colore può ottenere un colore predefinito dal renderer video. La chiave di colore predefinita può quindi essere installata nella finestra usando IOverlay::SetColorKey. I colori restituiti tramite questo metodo variano a seconda della modalità di visualizzazione corrente. Se i colori sono pallidi a 8 bit, saranno colori di sistema brillanti (ad esempio magenta). Se lo schermo si trova in modalità true-color, saranno sfumature di nero.
L'interfaccia IOverlay viene usata per garantire che le istanze separate del renderer nello stesso computer ottengano chiavi di colore diverse in modo che le sovrapposizioni non siano in conflitto.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | strmif.h (include Dshow.h) |
| Libreria | Strmiids.lib |