KsGateCaptureThreshold 函数 (ks.h)

项目
02/29/2024

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	任何级别