Metodo IMediaDet::WriteBitmapBits

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

Nota

[Deprecata. Questa API può essere rimossa dalle versioni future di Windows.]

 

Il WriteBitmapBits metodo recupera un fotogramma video nel tempo multimediale specificato e lo scrive in un file. Il fotogramma video è sempre in formato RGB a 24 bit.

Sintassi

HRESULT WriteBitmapBits(
   double StreamTime,
   long   Width,
   long   Height,
   BSTR   Filename
);

Parametri

StreamTime

Ora in cui recuperare il fotogramma video.

Width

Larghezza dell'immagine, in pixel.

Altezza

Altezza dell'immagine, in pixel.

Filename

Percorso del file in cui salvare la bitmap. Se il file esiste già, questo metodo lo sovrascrive.

Valore restituito

Restituisce S_OK esito positivo. In caso contrario, restituisce un valore HRESULT che indica la causa dell'errore. I codici di errore possibili includono quanto segue:

Codice restituito	Descrizione
E_NOINTERFACE	Impossibile aggiungere il filtro Sample Grabber al grafico.
E_FAIL	Esito negativo.
E_OUTOFMEMORY	Memoria insufficiente.
E_UNEXPECTED	Errore imprevisto.
STG_E_ACCESSDENIED	Impossibile sovrascrivere il file.
VFW_E_INVALIDMEDIATYPE	Tipo di supporto non valido.

 

Commenti

Prima di chiamare questo metodo, impostare il nome e il flusso del file chiamando IMediaDet::p ut_Filename e IMediaDet::p ut_CurrentStream.

Questo metodo inserisce il rilevatore multimediale in modalità di afferramento bitmap. Dopo aver chiamato questo metodo, i vari metodi di informazioni sul flusso in IMediaDet non funzionano, a meno che non si crei una nuova istanza del rilevatore multimediale.

Nota

Il file di intestazione Qedit.h non è compatibile con le intestazioni Direct3D successive alla versione 7.

 

Nota

Per ottenere Qedit.h, scaricare l'aggiornamento Microsoft Windows SDK per Windows Vista e .NET Framework 3.0. Qedit.h non è disponibile nella Microsoft Windows SDK per Windows 7 e .NET Framework 3.5 Service Pack 1.

 

Requisiti

Requisito	Valore
Intestazione	Qedit.h
Libreria	Strmiids.lib

Vedi anche

Interfaccia IMediaDet

Codici di errore e di esito positivo