Metodo IVMRMixerBitmap::SetAlphaBitmap (strmif.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 metodo SetAlphaBitmap specifica una nuova immagine bitmap e la posizione di origine della bitmap e come e dove deve essere eseguito il rendering nel rettangolo di destinazione.

Sintassi

HRESULT SetAlphaBitmap(
  [in] const VMRALPHABITMAP *pBmpParms
);

Parametri

[in] pBmpParms

Puntatore a una struttura VMRALPHABITMAP che contiene informazioni sulla bitmap.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, viene restituito un codice di errore.

Codice restituito	Descrizione
E_POINTER	pBmpParms è NULL.
E_INVALIDARG	Argomento non valido. Vedere la sezione Osservazioni.
E_OUTOFMEMORY	Impossibile creare un controller di dominio di destinazione o una diBSection per la bitmap.
E_FAIL	BitBlt alla superficie bitmap non riuscita.

Commenti

Per rimuovere la bitmap, impostare la struttura VMRALPHABITMAP e chiamare di nuovo SetAlphaBitmap .

Il metodo potrebbe restituire E_INVALIDARG per diversi motivi:

Il valore di fAlpha non è valido.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	strmif.h (include Dshow.h)
Libreria	Strmiids.lib