Condividi tramite


Metodo IVMRMixerBitmap::SetAlphaBitmap (strmif.h)

[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:

    [VMRALPHABITMAP] La struttura (/windows/desktop/api/strmif/ns-strmif-vmralphabitmap) contiene una combinazione non valida di flag. [VMRALPHABITMAP] La struttura (/windows/desktop/api/strmif/ns-strmif-vmralphabitmap) non specifica una superficie HDC o DirectDraw valida.
  • 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

Vedi anche

Codici di errore e di esito positivo

Interfaccia IVMRMixerBitmap

IVMRMixerBitmap::GetAlphaBitmapParameters

Uso del renderer di missaggio video

Filtro del renderer di combinazione video 7