Méthode IMiniportWavePciStream ::SetState (portcls.h)

La SetState méthode modifie l’état du transport de 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 miniports, KSSTATE_ACQUIRE et KSSTATE_PAUSE sont indisctinguibles.

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

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