pepfx.h) (PEP_REGISTER_DEVICE_V2 结构

项目
02/29/2024

PEP_REGISTER_DEVICE_V2结构描述了其驱动程序堆栈刚刚注册到 Windows 电源管理框架 (PoFx) 的设备。

语法

typedef struct _PEP_REGISTER_DEVICE_V2 {
  [in]  PCUNICODE_STRING           DeviceId;
  [in]  POHANDLE                   KernelHandle;
  [in]  PPEP_DEVICE_REGISTER_V2    Register;
  [out] PEPHANDLE                  DeviceHandle;
  [out] PEP_DEVICE_ACCEPTANCE_TYPE DeviceAccepted;
} PEP_REGISTER_DEVICE_V2, *PPEP_REGISTER_DEVICE_V2;

成员

[in] DeviceId

唯一标识设备的字符串。此成员是指向包含设备标识字符串的UNICODE_STRING结构的指针。

[in] KernelHandle

一个 POHANDLE 值，该值表示向 PoFx 注册设备。平台扩展插件 (PEP) 之前在通知 PEP 设备的驱动程序堆栈向 PoFx 注册了设备的 PEP_DPM_REGISTER_DEVICE 通知期间从 PoFx 收到此句柄。

[in] Register

指向描述设备中所有组件的电源管理属性的 PEP_DEVICE_REGISTER_V2 结构的指针。有关详细信息，请参阅“备注”。

[out] DeviceHandle

PEP 为标识此设备而创建的 PEPHANDLE 值。 PoFx 将使用此句柄在将来的设备电源管理 (DPM) 通知中标识设备。

[out] DeviceAccepted

一个PEP_DEVICE_ACCEPTANCE_TYPE枚举值，该值指示 PEP 是否声明设备的所有权。声明所有权的 PEP 负责处理设备的 DPM 通知。

注解

此结构由 PEP_DPM_REGISTER_DEVICE 通知使用。此结构的前三个成员包含 PoFx 提供的输入值。最后两个成员包含 PEP 写入结构以响应此通知的输出值。

Register 成员包含指向 PoFx 分配的输入缓冲区的指针。在将 PEP_DPM_REGISTER_DEVICE 通知发送到 PEP 之前，PoFx 会将 PEP_DEVICE_REGISTER_V2 结构和关联的数据写入此结构。此缓冲区的内容仅在 PEP 完成处理通知并从 AcceptDeviceNotification 回调返回之前保持有效。