IMiniportMidiStream::SetState-Methode (portcls.h)

  • Artikel

Die SetState -Methode legt den Transportstatus des Datenstroms auf einen neuen Zustandswert fest.

Syntax

NTSTATUS SetState(
  [in] KSSTATE State
);

Parameter

[in] State

Gibt den neuen Zustand an, auf den der Stream festgelegt werden soll. Dieser Parameter ist ein KSSTATE-Enumerationswert . Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

SetState gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück.

Hinweise

Für ein Audiofilterdiagramm werden die vier KSSTATE-Enumerationswerte wie folgt interpretiert:

  • KSSTATE_RUN

    Der Datentransport im aktuellen Audiofilterdiagramm wird ausgeführt und funktioniert wie gewohnt.

  • KSSTATE_ACQUIRE

    Dies ist ein Übergangszustand, der hilft, den Übergang zwischen KSSTATE_RUN und KSSTATE_STOP zu verwalten.

  • KSSTATE_PAUSE

    Dies ist ein Übergangszustand, der hilft, den Übergang zwischen KSSTATE_RUN und KSSTATE_STOP zu verwalten.

  • KSSTATE_STOP

    Der Datentransport wird im aktuellen Audiofilterdiagramm beendet.

Für die meisten Miniporttreiber sind KSSTATE_ACQUIRE und KSSTATE_PAUSE nicht zu unterscheiden. Die IMiniportMidi::NewStream-Methode legt den Anfangszustand des Streams auf KSSTATE_STOP fest.

Übergänge treten immer in einer der folgenden beiden Sequenzen auf:

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

Anforderungen

Anforderung Wert
Zielplattform Universell
Header portcls.h (portcls.h einschließen)
IRQL PASSIVE_LEVEL

Weitere Informationen

IMiniportMidi::NewStream

IMiniportMidiStream

KSPROPERTY_CONNECTION_STATE

KSSTATE