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 |