KsGateCaptureThreshold 函数 (ks.h)
KsGateCaptureThreshold 函数用于捕获 Gate 指定的 AND 门的 ON 输入。
语法
BOOLEAN KsGateCaptureThreshold(
[in] PKSGATE Gate
);
参数
[in] Gate
指向 KSGATE 结构的指针，该结构表示要同步捕获 ON 输入的 AND 门。
返回值
如果 AND 门最初打开，则 KsGateCaptureThreshold 返回 TRUE。 请注意，返回 TRUE 意味着门已关闭，因此其他线程无法同时捕获门并开始处理。
注解
KsGateCaptureThreshold 检查给定 AND 门的状态。 如果门处于打开状态，则会关闭入口的输入，从而将门转换为关闭状态。 如果门关闭，则函数不执行任何操作。 与 KsGateGetStateUnsafe 不同，此调用是针对其他门状态更改同步完成的。 它是基于门控进行处理的主要同步机制。
尽管名称如此，但此函数只是对 AND 门的有效调用，而不是一般入口。 但是，AVStream 不会验证 Gate 是 AND 门还是 OR 门。 调用方负责确保仅在 AND 门上进行呼叫。
调用是使用互锁函数进行的，因此对于任何其他门状态更改函数是同步的;这也是一种非常高效的过程控制方法。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX 中可用。 |
| 目标平台 | 桌面 |
| 标头 | ks.h (包括 Ks.h) |
| IRQL | 任何级别 |