IMXF::SetState-Methode (dmusicks.h)
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 |