pepfx.h) (PEP_POWER_CONTROL_COMPLETE 结构

PEP_POWER_CONTROL_COMPLETE结构包含 PEP 之前请求的电源控制操作以及设备驱动程序已完成的状态信息。

语法

typedef struct _PEP_POWER_CONTROL_COMPLETE {
  [in] PEPHANDLE DeviceHandle;
  [in] LPCGUID   PowerControlCode;
  [in] PVOID     RequestContext;
  [in] SIZE_T    BytesReturned;
  [in] NTSTATUS  Status;
} PEP_POWER_CONTROL_COMPLETE, *PPEP_POWER_CONTROL_COMPLETE;

成员

[in] DeviceHandle

用于标识设备的 PEPHANDLE 值。 PEP 提供此句柄以响应以前的 PEP_DPM_REGISTER_DEVICE 通知。

[in] PowerControlCode

指向 GUID 值的指针，该值指定已执行的电源控制操作。 此值与 PEP 在响应启动电源控制操作 PEP_DPM_WORK 通知时提供的值相同。

[in] RequestContext

指向 PEP 在原始工作请求中提供的 PEP_WORK_INFORMATION 结构中由 PEP 发送的请求上下文的指针。 通常，此成员指向一个结构，该结构包含指向输出缓冲区的指针，以包含 PEP 请求的电源控制操作的结果。

[in] BytesReturned

驱动程序在输出缓冲区中存储的结果数据的大小（以字节为单位）。 有关此缓冲区的详细信息，请参阅 RequestContext 成员的说明。

[in] Status

电源控制操作的状态。 如果操作成功，PEP 会将此成员设置为STATUS_SUCCESS。 否则，PEP 将此成员设置为相应的错误状态代码。

注解

此结构由 PEP_DPM_POWER_CONTROL_COMPLETE 通知使用。 结构的所有五个成员都包含由 提供的输入值

如果输出缓冲区太小，无法从操作接收所有结果数据，PEP 会将结构的 Status 成员设置为STATUS_INSUFFICIENT_RESOURCES，将 BytesReturned 成员设置为输出缓冲区所需的大小， (通常) 不向输出缓冲区写入任何数据。

要求

要求	值
最低受支持的客户端	从 Windows 10 开始支持。
标头	pepfx.h (包括 Pep_x.h)

另请参阅

GUID