通过

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