Condividi tramite


Metodo CBaseControlVideo.GetCurrentImage

[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 GetCurrentImage metodo recupera una copia dell'immagine corrente nel renderer.

Sintassi

HRESULT GetCurrentImage(
   long *pBufferSize,
   long *pVideoImage
);

Parametri

pBufferSize

Puntatore alle dimensioni del buffer di output.

pVideoImage

Puntatore al buffer di output per l'immagine.

Valore restituito

Restituisce un valore HRESULT che dipende dall'implementazione; può essere uno dei valori seguenti o altri valori non elencati.

Codice restituito Descrizione
E_FAIL
Esito negativo.
E_INVALIDARG
Argomento non valido.
E_OUTOFMEMORY
Memoria insufficiente. Restituito quando il parametro pVideoInfo è NULL.
NOERROR
Operazione completata.
VFW_E_NOT_PAUSED
Impossibile eseguire l'operazione perché il filtro non è sospeso.

Commenti

Questa funzione membro recupera l'immagine dall'esempio e la copia nel buffer di output. La sezione del video copiata nel buffer di output riflette il rettangolo di origine impostato tramite l'interfaccia IBasicVideo . Non riflette il rettangolo di destinazione.

Requisiti

Requisito Valore
Intestazione
Ctlutil.h (includere Streams.h)
Libreria
Strmbase.lib (build al dettaglio);
Strmbasd.lib (build di debug)

Vedi anche

Classe CBaseControlVideo