KsGateCaptureThreshold, fonction (ks.h)
La fonction KsGateCaptureThreshold est utilisée pour capturer une entrée ON d’une porte AND spécifiée par Gate.
Syntaxe
BOOLEAN KsGateCaptureThreshold(
[in] PKSGATE Gate
);
Paramètres
[in] Gate
Pointeur vers une structure KSGATE représentant la porte AND pour laquelle capturer une entrée ON de manière synchrone.
Valeur retournée
KsGateCaptureThreshold retourne TRUE si la porte AND était ouverte à l’origine. Notez que le retour de TRUE implique que la porte a été fermée afin qu’aucun autre thread ne puisse capturer simultanément la porte et commencer le traitement.
Remarques
KsGateCaptureThreshold vérifie l’état de la porte AND donnée. Si la porte est ouverte, elle désactive une entrée à la porte, faisant ainsi passer la porte à un état fermé. Si la porte est fermée, la fonction ne fait rien. Contrairement à KsGateGetStateUnsafe, cet appel est effectué de manière synchrone par rapport aux autres changements d’état de la porte. Il s’agit du mécanisme de synchronisation principal pour le traitement basé sur le contrôle de la porte.
Malgré son nom, cette fonction n’est qu’un appel valide pour les portes AND, et non pour les portes en général. TOUTEFOIS, AVStream ne vérifie pas si Gate est une porte AND ou une porte OR. Il incombe à l’appelant de s’assurer que l’appel est effectué uniquement sur les portes AND.
L’appel est effectué à l’aide de fonctions verrouillées et est donc synchrone par rapport à l’une des autres fonctions de changement d’état de porte ; il s’agit également d’une méthode très efficace de contrôle de processus.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | ks.h (inclure Ks.h) |
| IRQL | N’importe quel niveau |