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 不会验证 是 AND 门还是 OR 门。 呼叫者有责任确保呼叫仅在 AND 门上进行。

调用是使用互锁函数进行的,因此与任何其他门状态更改函数同步;这也是一种非常高效的过程控制方法。

要求

要求 价值
最低支持的客户端 Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。
目标平台 桌面
标头 ks.h (包括 Ks.h)
IRQL 任何级别

另请参阅

KsGateAddOffInputToAnd

KsGateAddOffInputToOr

KsGateAddOnInputToAnd

KsGateAddOnInputToOr

KsGateGetStateUnsafe

KsGateInitializeAnd

KsGateInitializeOr

KsGateRemoveOffInputFromAnd

KsGateRemoveOffInputFromOr

KsGateRemoveOnInputFromAnd

KsGateRemoveOnInputFromOr

KsGateTurnInputOff

KsGateTurnInputOn