Metodo IMiniportWaveCyclicStream::SetState (portcls.h)

  • Articolo

Il SetState metodo imposta il nuovo stato di riproduzione o registrazione per il flusso.

Sintassi

NTSTATUS SetState(
  [in] KSSTATE State
);

Parametri

[in] State

Specifica il nuovo stato per 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 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 normale.

  • KSSTATE_ACQUIRE

    Si tratta di uno stato di transizione che consente di gestire la transizione tra KSSTATE_RUN e KSSTATE_STOP.

  • KSSTATE_PAUSE

    Si tratta di uno stato di transizione 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 indistinguishable.

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

  • STOP -> ACQUIRE -> PAUSE -> RUN
  • RUN -> PAUSE -> ACQUIRE -> STOP
Il metodo IMiniportWaveCyclic::NewStream imposta lo stato iniziale del flusso su KSSTATE_STOP.

Requisiti

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

Vedi anche

IMiniportWaveCyclic::NewStream

IMiniportWaveCyclicStream

KSPROPERTY_CONNECTION_STATE

KSSTATE