DRIVER_PROXY_FEATURE_FLAGS union (wdm.h)

DRIVER_PROXY_FEATURE_FLAGS结构包含指示当前系统和驱动程序的 DriverProxy 功能的可用性和状态的功能标志。

Syntax

typedef union _DRIVER_PROXY_FEATURE_FLAGS {
  ULONG  AsUlong;
  struct {
    ULONG Enabled : 1;
    ULONG Reserved : 31;
  };
} DRIVER_PROXY_FEATURE_FLAGS, *PDRIVER_PROXY_FEATURE_FLAGS;

Members

AsUlong

完整的功能标志集作为单个 ULONG 值。 这样就可以以 32 位整数的形式访问所有标志,以便轻松进行初始化、比较或存储。

Enabled

一个单位标志,指示 DriverProxy 功能是否已启用且可用。 当此位设置为 1 时,可以成功使用 IoCreateDriverProxyExtensionIoRegisterDriverProxyEndpoints 等 DriverProxy API。 当此位为 0 时,DriverProxy 功能不可用。

Reserved

保留位供将来使用。 这些位当前未使用,应被驱动程序忽略。 它们用于将来扩展 DriverProxy 功能标志。

注解

IoGetDriverProxyFeatures 使用此结构返回有关 DriverProxy 热交换功能是否受支持和启用的信息。 驱动程序应调用此函数来检索结构,并在尝试使用 DriverProxy API 之前检查 已启用 的标志。

“启用”标志是根据多个系统条件设置的,包括:

  • 安全内核必须正在运行
  • 必须为 DriverProxy作配置系统
  • 不得通过注册表设置从 DriverProxy 功能中排除驱动程序
  • 不得全局禁用 DriverProxy

驱动程序应在将其传递给 IoGetDriverProxyFeatures 之前将此结构初始化为零,以确保任何未初始化的位不包含随机值。

要求

Requirement 价值
Header wdm.h

另请参阅

IoGetDriverProxyFeatures

IoCreateDriverProxyExtension

IoRegisterDriverProxyEndpoints