Freigeben über

IMiniportWavePciStream::SetState-Methode (portcls.h)

  • Artikel

Die SetState-Methode ändert den Status des Datenstromtransports.

Syntax

NTSTATUS SetState(
  [in] KSSTATE State
);

Parameter

[in] State

Gibt den neuen Status des Datenstroms 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 Anruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück.

Bemerkungen

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

  • KSSTATE_RUN

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

  • 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 Miniports sind KSSTATE_ACQUIRE und KSSTATE_PAUSE nicht zu unterscheiden.

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

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

Anforderungen

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

Siehe auch

IMiniportWavePci::NewStream

IMiniportWavePciStream-

KSPROPERTY_CONNECTION_STATE

KSSTATE-