Partager via

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

  • Article

La méthode SetState définit l’état de transport du flux sur une nouvelle valeur d’état.

Syntaxe

NTSTATUS SetState(
  [in] KSSTATE State
);

Paramètres

[in] State

Spécifie le nouvel état sur lequel le flux doit être défini. 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 pilotes miniports, KSSTATE_ACQUIRE et KSSTATE_PAUSE sont indistinguishables. La méthode IMiniportMidi ::NewStream définit l’état initial du flux sur KSSTATE_STOP.

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

  • STOP -> ACQUIRE -> PAUSE -> RUN
  • RUN -> PAUSE -> ACQUIRE -> STOP

Exigences

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

Voir aussi

IMiniportMidi ::NewStream

IMiniportMidiStream

KSPROPERTY_CONNECTION_STATE

KSSTATE