Metodo IOverlay::SetColorKey (strmif.h)

  • Articolo

[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 SetColorKey metodo modifica la chiave di colore.

Sintassi

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

Parametri

[in, out] pColorKey

Puntatore al valore della chiave di colore da impostare. Se ha esito positivo, il valore effettivo della chiave di colore selezionato viene copiato in questo parametro.

Valore restituito

Restituisce S_OK se ha esito positivo, E_POINTER se pColorKey è NULL o E_INVALIDARG se il valore di pColorKey non è valido per il formato corrente di tavolozza o pixel.

Commenti

Se si modifica la chiave di colore usando il SetColorKey metodo, tutti i collegamenti consigliati riceveranno un metodo di callback IOverlayNotify::OnColorKeyChange con il nuovo colore.

Quando si usa IOverlay::Consiglia su un display palttizzato, un filtro può installare una chiave di colore (usando ) o installare una tavolozza (usando SetColorKeyIOverlay::SetPalette), ma non entrambi. Ciò è dovuto al fatto che i tasti di colore in questa modalità richiedono che una tavolozza venga resa conto che sarebbe in conflitto con SetPalette. Le chiavi di colore possono essere disinstallate richiedendo una chiave di colore con il flag di CK_NOCOLORKEY. Analogamente, qualsiasi tavolozza installata tramite SetPalette può essere disinstallata chiamando SetPalette e passando i parametri NULL , ovvero SetPalette(0,NULL)).

Il tentativo di impostare una tavolozza quando viene installata una chiave di colore restituisce un errore VFW_E_PALETTE_SET. Prova a impostare una chiave di colore quando viene installata una tavolozza restituisce VFW_E_COLOR_KEY_SET.

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

Vedi anche

Codici errore e esito positivo

Interfaccia IOverlay