Condividi tramite

Metodo IMiniportWavePciStream::SetState (portcls.h)

  • Articolo

Il metodo SetState modifica lo stato del trasporto del flusso.

Sintassi

NTSTATUS SetState(
  [in] KSSTATE State
);

Parametri

[in] State

Specifica il nuovo stato del flusso. Questo parametro è un valore di enumerazione KSSTATE. Per altre informazioni, vedere la sezione Osservazioni seguente.

Valore restituito

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

Osservazioni

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 miniport, KSSTATE_ACQUIRE e KSSTATE_PAUSE sono indistinguibili.

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

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

Fabbisogno

Requisito Valore
piattaforma di destinazione Universale
intestazione portcls.h (include Portcls.h)
IRQL PASSIVE_LEVEL

Vedere anche

IMiniportWavePci::NewStream

IMiniportWavePciStream

KSPROPERTY_CONNECTION_STATE

KSSTATE