Metodo IMediaFilter::GetState (strmif.h)
[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 metodo GetState recupera lo stato del filtro (in esecuzione, arrestato o sospeso).
Sintassi
HRESULT GetState(
[in] DWORD dwMilliSecsTimeout,
[out] FILTER_STATE *State
);
Parametri
[in] dwMilliSecsTimeout
Intervallo di timeout, in millisecondi. Per bloccare in modo indefinito, usare il valore INFINITE.
[out] State
Riceve un membro del tipo enumerato FILTER_STATE , che indica lo stato del filtro.
Valore restituito
Restituisce un valore HRESULT . I valori possibili includono quelli visualizzati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata. |
|
Argomento puntatore NULL. |
|
Stato intermedio. |
|
Il filtro è attivo, ma non può recapitare i dati. |
Commenti
Le transizioni di stato possono essere asincrone. Se il filtro passa a un nuovo stato e il metodo viene eseguito il timeout prima del completamento della transizione, il metodo restituisce VFW_S_STATE_INTERMEDIATE.
Se un filtro non può recapitare dati per qualche motivo, restituisce VFW_S_CANT_CUE. I filtri di acquisizione in tempo reale restituiscono questo valore durante la sospensione, perché non recapitano i dati nello stato sospeso.
Per altre informazioni, vedere Flusso di dati in Filter Graph.
Requisiti
| 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 |