Metodo IAMDroppedFrames::GetNumDropped (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 GetNumDropped metodo recupera il numero totale di fotogrammi eliminati dal filtro dall'avvio del flusso.
Sintassi
HRESULT GetNumDropped(
[out] long *plDropped
);
Parametri
[out] plDropped
Puntatore a una variabile che riceve il numero di fotogrammi eliminati.
Valore restituito
Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. |
|
Argomento puntatore NULL. |
Commenti
Il filtro reimposta il conteggio su zero quando passa da arrestato a sospeso.
Se l'applicazione usa l'interfaccia IAMStreamControl per controllare un pin, il driver potrebbe continuare a contare fotogrammi eliminati e non rilasciati mentre il pin è disattivato. Per ottenere un conteggio accurato, chiamare questo metodo una volta quando si attiva il pin e di nuovo quando si disattiva il pin. La differenza è il numero totale di fotogrammi eliminati. Se l'ora di inizio viene eseguita in un secondo momento rispetto alla chiamata a IAMStreamControl::StartAt, l'applicazione deve restare in ascolto dell'evento EC_STREAM_CONTROL_STARTED . Queste osservazioni si applicano anche se l'applicazione usa il metodo ICaptureGraphBuilder2::ControlStream .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | strmif.h (include Dshow.h) |
| Libreria | Strmiids.lib |