Metodo IMediaDet::GetSampleGrabber
[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.
Nota
[Deprecata. Questa API può essere rimossa dalle versioni future di Windows.]
Il GetSampleGrabber metodo recupera un puntatore all'interfaccia ISampleGrabber , che consente a un'applicazione di recuperare singoli esempi da un flusso multimediale.
Sintassi
HRESULT GetSampleGrabber(
[out] ISampleGrabber **ppVal
);
Parametri
-
ppVal [out]
-
Riceve un puntatore all'interfaccia ISampleGrabber .
Valore restituito
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Chiamare IMediaDet::EnterBitmapGrabMode prima di chiamare questo metodo. L'interfaccia ISampleGrabber consente di recuperare singoli esempi multimediali dal flusso. Se è sufficiente una bitmap da un frame video, chiamare invece il metodo IMediaDet::GetBitmapBits . L'interfaccia ISampleGrabber è più flessibile, ma richiede più lavoro dall'applicazione.
Se questo metodo ha esito positivo, l'interfaccia ISampleGrabber restituita ha un numero di riferimenti in sospeso. Assicurarsi di rilasciare l'interfaccia al termine dell'uso.
Nota
Il file di intestazione Qedit.h non è compatibile con 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 |
|
| Libreria |
|
Vedi anche