KsGateCaptureThreshold-Funktion (ks.h)
Die KsGateCaptureThreshold-Funktion wird verwendet, um eine ON-Eingabe eines durch Gate angegebenen AND-Gates zu erfassen.
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-Gate ursprünglich geöffnet war. Beachten Sie, dass die Rückgabe von TRUE impliziert, dass das Gate geschlossen wurde, sodass kein anderer Thread gleichzeitig das Gate erfassen und mit der Verarbeitung beginnen konnte.
Hinweise
KsGateCaptureThreshold überprüft den Zustand des angegebenen AND-Gates. Wenn das Gate geöffnet ist, wird eine Eingabe für das Gate deaktiviert, wodurch das Gate in einen geschlossenen Zustand übergeht. Wenn das Gate geschlossen ist, macht die Funktion nichts. Im Gegensatz zu KsGateGetStateUnsafe erfolgt dieser Aufruf synchron in Bezug auf andere Gatezustandsänderungen. Dies ist der primäre Synchronisierungsmechanismus für die Verarbeitung basierend auf der Gatesteuerung.
Trotz ihres Namens ist diese Funktion nur ein gültiger Aufruf für AND-Gates, nicht für Gates im Allgemeinen. AVStream überprüft jedoch nicht, ob Gate ein AND-Gate oder ein OR-Gate ist. Es liegt in der Verantwortung des Anrufers sicherzustellen, dass der Anruf nur auf AND-Gates erfolgt.
Der Aufruf erfolgt mithilfe von ineinandergreifenden Funktionen und ist daher synchron im Hinblick auf eine der anderen Gatezustandsänderungsfunktionen; es ist auch eine sehr effiziente Methode der Prozesssteuerung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen sowie DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Desktop |
| Kopfzeile | ks.h (ks.h einschließen) |
| IRQL | Beliebige Ebene |