PEP_POWER_CONTROL_COMPLETE結構（pep_x.h）

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 通知而提供的 PEP 起始電源控制作業相同。

[in] RequestContext

PEP 在原始工作要求中提供的 PEP 所傳送之 PEP_WORK_INFORMATION 結構中，要求內容的指標。 一般而言，這個成員會指向包含輸出緩衝區指標的結構，以包含 PEP 所要求的電源控制作業結果。

[in] BytesReturned

驅動程式在輸出緩衝區中儲存之結果數據的大小，以位元組為單位。 如需此緩衝區的詳細資訊，請參閱 requestContext 成員 的描述。

[in] Status

電源控制作業的狀態。 如果作業成功，PEP 會將此成員設定為STATUS_SUCCESS。 否則，PEP 會將這個成員設定為適當的錯誤狀態代碼。

言論

PEP_DPM_POWER_CONTROL_COMPLETE 通知會使用此結構。 結構的所有五個成員都包含 提供的輸入值

如果輸出緩衝區太小而無法從作業接收所有結果數據，PEP 會將結構的 Status 成員設定為STATUS_INSUFFICIENT_RESOURCES、將 BytesReturned 成員設定為所需的輸出緩衝區大小，且 （通常） 不會將數據寫入輸出緩衝區。

要求

要求	價值
最低支援的用戶端	從 Windows 10 開始支援。
標頭	pep_x.h （包括 Pep_x.h）

另請參閱

GUID