KsGateGetStateUnsafe-Funktion (ks.h)

Die KsGateGetStateUnsafe-Funktion gibt den Zustand des angegebenen Gates (geöffnet oder geschlossen) auf unsichere Weise zurück, d. h. ohne Berücksichtigung der Synchronisierung.

Syntax

BOOLEAN KsGateGetStateUnsafe(
  [in] PKSGATE Gate
);

Parameter

[in] Gate

Ein Zeiger auf eine KSGATE-Struktur , die das Gate darstellt, für das der Zustand zurückgegeben werden soll.

Rückgabewert

Dieser Aufruf gibt TRUE zurück, wenn das Gate geöffnet ist, und FALSE , wenn das Gate geschlossen ist.

Hinweise

Da KsGateGetStateUnsafe die Synchronisierung nicht verarbeitet, ist es möglich, ein Ergebnis zu erhalten, das nicht mit dem Zustand des Gates konsistent ist, wenn sich das Gate zum Zeitpunkt des Aufrufs in der Mitte des Übergangs von einem Zustand zu einem anderen befindet.

Betrachten Sie eine Situation, in der die Ausgabe von Gate A als Eingabe mit Gate B verbunden ist. A übergibt zu geschlossen, was dazu führt, dass B von offen zu geschlossen wechselt. Wenn gleichzeitig ein anderer Thread KsGateGetStateUnsafe zwischen dem Schließen von A und dem Zeitpunkt des Schließens von B aufruft, gibt die Routine weiterhin zurück, dass B geöffnet war.

KsGateGetStateUnsafe gibt zurück, ob Gate-Count> größer als 0 ist. Die Funktion verwendet hierfür keine ineinandergreifenden Funktionen. Daher erfolgt der Aufruf ohne Berücksichtigung der Synchronisierung.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen.
Zielplattform	Desktop
Kopfzeile	ks.h (einschließlich Ks.h)
IRQL	Beliebige Ebene