Partager via


IMiniportWaveCyclicStream ::SetState, méthode (portcls.h)

La SetState méthode définit le nouvel état de lecture ou d’enregistrement pour le flux.

Syntaxe

NTSTATUS SetState(
  [in] KSSTATE State
);

Paramètres

[in] State

Spécifie le nouvel état du flux. Ce paramètre est une valeur d’énumération KSSTATE . Pour plus d'informations, consultez la section Notes qui suit.

Valeur retournée

SetState retourne STATUS_SUCCESS si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié.

Remarques

Pour un graphique de filtre audio, les quatre valeurs d’énumération KSSTATE sont interprétées comme suit :

  • KSSTATE_RUN

    Le transport des données dans le graphique de filtre audio actuel s’exécute et fonctionne normalement.

  • KSSTATE_ACQUIRE

    Il s’agit d’un état transitoire qui permet de gérer la transition entre KSSTATE_RUN et KSSTATE_STOP.

  • KSSTATE_PAUSE

    Il s’agit d’un état transitoire qui permet de gérer la transition entre KSSTATE_RUN et KSSTATE_STOP.

  • KSSTATE_STOP

    Le transport de données est arrêté dans le graphique de filtre audio actuel.

Pour la plupart des pilotes miniport, KSSTATE_ACQUIRE et KSSTATE_PAUSE sont indisctinguables.

Les transitions se produisent toujours dans l’une des deux séquences suivantes :

  • STOP -> ACQUIRE -> PAUSE -> RUN
  • RUN -> PAUSE -> ACQUIRE -> STOP
La méthode IMiniportWaveCyclic ::NewStream définit l’état initial du flux sur KSSTATE_STOP.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête portcls.h (include Portcls.h)
IRQL PASSIVE_LEVEL

Voir aussi

IMiniportWaveCyclic ::NewStream

IMiniportWaveCyclicStream

KSPROPERTY_CONNECTION_STATE

KSSTATE