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