Partager via

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

  • Article

La méthode SetState modifie l’état du transport de 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 Remarques suivante.

Valeur de retour

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 de données dans le graphique de filtre audio actuel est en cours d’exécution et fonctionne normalement.

  • KSSTATE_ACQUIRE

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

  • KSSTATE_PAUSE

    Il s’agit d’un état transitionnel 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 indistinguishables.

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

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

Exigences

Exigence Valeur
plateforme cible Universel
d’en-tête portcls.h (include Portcls.h)
IRQL PASSIVE_LEVEL

Voir aussi

IMiniportWavePci ::NewStream

IMiniportWavePciStream

KSPROPERTY_CONNECTION_STATE

KSSTATE