Freigeben über


IMiniportWaveCyclicStream::SetState-Methode (portcls.h)

Die SetState -Methode legt den neuen Status der Wiedergabe oder Aufzeichnung für den Stream fest.

Syntax

NTSTATUS SetState(
  [in] KSSTATE State
);

Parameter

[in] State

Gibt den neuen Status für den Stream an. 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 entsprechenden 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 den Übergang zwischen KSSTATE_RUN und KSSTATE_STOP.

  • KSSTATE_PAUSE

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

  • KSSTATE_STOP

    Der Datentransport wird im aktuellen Audiofilterdiagramm beendet.

Für die meisten Miniporttreiber sind KSSTATE_ACQUIRE und KSSTATE_PAUSE nicht zu unterscheiden.

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

  • STOP -> ACQUIRE -> PAUSE -> RUN
  • AUSFÜHREN VON -> PAUSE -> ACQUIRE -> STOP
Die IMiniportWaveCyclic::NewStream-Methode legt den Anfangszustand des Datenstroms auf KSSTATE_STOP fest.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header portcls.h (include Portcls.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

IMiniportWaveCyclic::NewStream

IMiniportWaveCyclicStream

KSPROPERTY_CONNECTION_STATE

KSSTATE