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。
要求
要求 | 值 |
---|---|
最低 KMDF 版本 | 1.0 |
最低 UMDF 版本 | 2.0 |
标头 | wdfdevice.h (包括 Wdf.h) |