KsGateGetStateUnsafe 函数 (ks.h)

KsGateGetStateUnsafe 函数以不安全的方式返回给定门的状态, (打开或关闭) ,这与同步无关

语法

BOOLEAN KsGateGetStateUnsafe(
  [in] PKSGATE Gate
);

参数

[in] Gate

指向 KSGATE 结构的指针,该结构表示要为其返回状态的门。

返回值

如果门处于打开状态,则此调用返回 TRUE ,如果门关闭,则返回 FALSE

注解

由于 KsGateGetStateUnsafe 不处理同步,因此,如果门在调用时处于从一种状态到另一种状态的中间转换,则可能会得到与门的状态不一致的结果。

请考虑将门 A 的输出作为输入连接到门 B 的情况。转换为关闭,导致 B 从开放转换为关闭。 如果同时,另一个线程在 A 关闭和 B 关闭之间调用 KsGateGetStateUnsafe ,则例程仍返回 B 已打开。

KsGateGetStateUnsafe 返回 Gate-Count> 是否大于零。 函数不使用任何互锁函数来执行此操作。 因此,执行调用而不考虑同步。

要求

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