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

Article
03/05/2024

La SetState méthode 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 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. 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 :