Metodo IMiniportMidiStream::SetState (portcls.h)

Articolo
02/27/2024

Il SetState metodo imposta lo stato di trasporto del flusso su un nuovo valore di stato.

Sintassi

NTSTATUS SetState(
  [in] KSSTATE State
);

Parametri

[in] State

Specifica il nuovo stato su cui deve essere impostato il flusso. Questo parametro è un valore di enumerazione KSSTATE . Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Valore restituito

SetState restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato.

Commenti

Per un grafico di filtro audio, i quattro valori di enumerazione KSSTATE vengono interpretati come segue:

KSSTATE_RUN
Il trasporto dei dati nel grafico del filtro audio corrente è in esecuzione e funziona come di consueto.
KSSTATE_ACQUIRE
Si tratta di uno stato transitorio che consente di gestire la transizione tra KSSTATE_RUN e KSSTATE_STOP.
KSSTATE_PAUSE
Si tratta di uno stato transitorio che consente di gestire la transizione tra KSSTATE_RUN e KSSTATE_STOP.
KSSTATE_STOP
Il trasporto dati viene arrestato nel grafico del filtro audio corrente.

Per la maggior parte dei driver miniport, KSSTATE_ACQUIRE e KSSTATE_PAUSE sono indistingubili. Il metodo IMiniportMidi::NewStream imposta lo stato iniziale del flusso su KSSTATE_STOP.

Le transizioni si verificano sempre in una delle due sequenze seguenti: