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 结构用作参数，用于 WdfDeviceSetDeviceState，WdfDeviceGetDeviceState。

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

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

要求