Freigeben über


KsGateCaptureThreshold-Funktion (ks.h)

Die KsGateCaptureThreshold Funktion wird verwendet, um eine ON-Eingabe eines AND-Gates zu erfassen, das durch Gate-angegeben wird.

Syntax

BOOLEAN KsGateCaptureThreshold(
  [in] PKSGATE Gate
);

Parameter

[in] Gate

Ein Zeiger auf eine KSGATE- Struktur, die das AND-Gate darstellt, für das eine ON-Eingabe synchron erfasst werden soll.

Rückgabewert

KsGateCaptureThreshold gibt TRUE- zurück, wenn das AND-Tor ursprünglich geöffnet war. Beachten Sie, dass die Rückgabe TRUE impliziert, dass das Tor geschlossen wurde, sodass kein anderer Thread gleichzeitig das Tor erfassen und mit der Verarbeitung beginnen konnte.

Bemerkungen

KsGateCaptureThreshold überprüft den Zustand des angegebenen AND-Gates. Wenn das Tor geöffnet ist, deaktiviert es eine Eingabe an das Tor und übergibt das Tor in einen geschlossenen Zustand. Wenn das Tor geschlossen ist, führt die Funktion nichts aus. Im Gegensatz zu KsGateGetStateUnsafeerfolgt dieser Aufruf synchron in Bezug auf andere Gate-Zustandsänderungen. Es ist der primäre Synchronisierungsmechanismus für die Verarbeitung basierend auf der Gate-Steuerung.

Trotz seines Namens ist diese Funktion nur ein gültiger Aufruf für UND Tore, nicht tore im Allgemeinen. AVStream überprüft jedoch nicht, ob Gate ein AND-Tor oder ein OR-Tor ist. Es liegt in der Verantwortung des Anrufers, sicherzustellen, dass der Anruf nur an AND-Toren erfolgt.

Der Aufruf erfolgt über verriegelte Funktionen und ist somit synchron in Bezug auf eine der anderen Gate-Zustandsänderungsfunktionen; es ist auch eine sehr effiziente Methode der Prozesssteuerung.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher directX-Versionen.
Zielplattform- Desktop
Header- ks.h (enthalten Ks.h)
IRQL- Beliebige Ebene

Siehe auch

KsGateAddOffInputToAnd

KsGateAddOffInputToOr

KsGateAddOnInputToAnd

KsGateAddOnInputToOr

KsGateGetStateUnsafe-

KsGateInitializeAnd

KsGateInitializeOr

KsGateRemoveOffInputFromAnd

KsGateRemoveOffInputFromOr

KsGateRemoveOnInputFromAnd

KsGateRemoveOnInputFromOr

KsGateTurnInputOff

KsGateTurnInputOn