WDF_DEVICE_STATE 结构 (wdfdevice.h)

[适用于 KMDF 和 UMDF]

WDF_DEVICE_STATE结构指定设备的即插即用状态。

语法

typedef struct _WDF_DEVICE_STATE {
  ULONG         Size;
  WDF_TRI_STATE Disabled;
  WDF_TRI_STATE DontDisplayInUI;
  WDF_TRI_STATE Failed;
  WDF_TRI_STATE NotDisableable;
  WDF_TRI_STATE Removed;
  WDF_TRI_STATE ResourcesChanged;
  WDF_TRI_STATE AssignedToGuest;
} WDF_DEVICE_STATE, *PWDF_DEVICE_STATE;

成员

Size

此结构的大小(以字节为单位)。

Disabled

一个WDF_TRI_STATE类型的值,如果设置为 WdfTrue,则表示设备已禁用。 有关 WDF_TRI_STATE 类型的详细信息,请参阅以下“备注”部分。

DontDisplayInUI

一个WDF_TRI_STATE类型的值,如果设置为 WdfTrue,则指示设备处于隐藏状态, (未在 设备管理器 中) 显示。 有关详细信息,请参阅 查看隐藏的设备。 (将此成员设置为 WdfTrue 后,更改其值不起作用。)

Failed

WDF_TRI_STATE类型的值,如果设置为 WdfTrue,则指示设备存在但已失败。

NotDisableable

WDF_TRI_STATE类型的值,如果设置为 WdfTrue,则指示无法禁用设备。

Removed

一个WDF_TRI_STATE类型的值,如果设置为 WdfTrue,则表示设备已被删除。

ResourcesChanged

WDF_TRI_STATE类型的值,如果设置为 WdfTrue,则表示设备的资源要求已更改。

AssignedToGuest

一个WDF_TRI_STATE类型的值,如果设置为 WdfTrue,则指示设备报告自己已分配给来宾分区。

注解

结构成员使用 WDF_TRI_STATE 类型。 值 WdfUseDefault 表示框架将使用堆栈中较低级驱动程序提供的值。 例如,如果总线驱动程序为 NotDisable 指定 WdfTrue,并且设备的函数驱动程序指定 WdfUseDefault,则框架将使用 WdfTrue 作为设备状态。

WDF_DEVICE_STATE 结构用作 WdfDeviceSetDeviceStateWdfDeviceGetDeviceState 的参数。

若要初始化 WDF_DEVICE_STATE 结构,驱动程序必须调用 WDF_DEVICE_STATE_INIT

有关 WDF_DEVICE_STATE 结构的成员的详细信息,请参阅 PNP_DEVICE_STATE

要求

要求
最低 KMDF 版本 1.0
最低 UMDF 版本 2.0
标头 wdfdevice.h (包括 Wdf.h)