Freigeben über

IMXF::SetState-Methode (dmusicks.h)

  • Artikel

Die SetState-Methode wird verwendet, um den Zustand der MIDI-Transformationsschnittstelle festzulegen.

Syntax

NTSTATUS SetState(
  KSSTATE State
);

Parameter

State

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

Rückgabewert

Diese Methode gibt NTSTATUS zurück, das STATUS_SUCCESS enthält, 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:

Wert State
KSSTATE_RUN Alles läuft und funktioniert wie gewohnt. In diesem Zustand ist die IMXF-Schnittstelle aktiv und übergibt nachrichten wie gewohnt.
KSSTATE_ACQUIRE Dies ist ein Übergangszustand, der den Übergang zwischen KSSTATE_RUN und KSSTATE_STOP erleichtert. In diesem Zustand können Nachrichten nicht im Filterdiagramm nachgeschaltet übergeben werden.
KSSTATE_PAUSE Dies ist ein Übergangszustand, der den Übergang zwischen KSSTATE_RUN und KSSTATE_STOP erleichtert.
KSSTATE_STOP Im aktuellen Filterdiagramm wird alles angehalten.

Das Verhalten des Miniporttreibers hängt vom Zustand des Filterdiagramms ab. Dieses Verhalten unterscheidet sich beim Rendern (Ausgabe) und erfassen (Eingabe).

Wenn der aktuelle Zustand auf der Ausgabeseite nicht KSSTATE_RUN ist, sollte die IMXF-Schnittstelle die Daten behalten und nicht an die Hardware übergeben werden. Wenn der aktuelle Zustand KSTATE_STOP, sollte der Miniporttreiber alle Daten verwerfen, die ihm durch Die Übergabe dieser Daten an den Zuweisungsgeber gegeben werden.

Wenn sich der Eingabedatenstrom auf der Eingabeseite entweder in KSSTATE_RUN oder KSSTATE_PAUSE befindet, ist es zulässig, dass der Miniporttreiber Nachrichten vom Allocator erhält und sie Upstream an die Erfassungssenke sendet. Wenn der Zustand KSSTATE_STOP oder KSSTATE_ACQUIRE ist und die Hardware versucht, Daten zu erzeugen, sollten diese Daten weggeworfen werden.

Anforderungen

Anforderung Wert
Header dmusicks.h
IRQL PASSIVE_LEVEL

Weitere Informationen

IMXF