PEP_POWER_CONTROL_COMPLETE結構 (pepfx.h)

  • 發行項

PEP_POWER_CONTROL_COMPLETE 結構包含先前要求的電源控制作業狀態資訊，以及設備驅動器已完成。

語法

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 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 開始支援。
標頭 pepfx.h (include Pep_x.h)

另請參閱

GUID