Metodo IMiniportMidiStream::SetState (portcls.h)

  • Articolo

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:

  • STOP -> ACQUIRE -> PAUSE -> RUN
  • RUN -> PAUSE -> ACQUIRE -> STOP

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Intestazione portcls.h (include Portcls.h)
IRQL PASSIVE_LEVEL

Vedi anche

IMiniportMidi::NewStream

IMiniportMidiStream

KSPROPERTY_CONNECTION_STATE

KSSTATE