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
);

[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.

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

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 :

La méthode IMiniportWaveCyclic ::NewStream définit l’état initial du flux sur KSSTATE_STOP.