Metodo IMediaFilter::GetState (strmif.h)

  • Articolo

[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
S_OK
 Operazione completata.
E_POINTER
 Argomento puntatore NULL.
VFW_S_STATE_INTERMEDIATE
 Stato intermedio.
VFW_S_CANT_CUE
 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

Vedi anche

Codici errore e esito positivo

IBaseFilter

Interfaccia IMediaFilter