struktur PEP_POWER_CONTROL_COMPLETE (pep_x.h)

  • Artikel

Struktur PEP_POWER_CONTROL_COMPLETE berisi informasi status untuk operasi kontrol daya yang sebelumnya diminta PEP dan driver perangkat telah selesai.

Sintaks

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;

Anggota

[in] DeviceHandle

Nilai PEPHANDLE yang mengidentifikasi perangkat. PEP menyediakan handel ini sebagai respons terhadap pemberitahuan PEP_DPM_REGISTER_DEVICE sebelumnya.

[in] PowerControlCode

Penunjuk ke nilai GUID yang menentukan operasi kontrol daya yang dilakukan. Ini adalah nilai yang sama dengan yang disediakan PEP sebagai respons terhadap pemberitahuan PEP_DPM_WORK untuk memulai operasi kontrol daya.

[in] RequestContext

Penunjuk ke konteks permintaan yang dikirim oleh PEP dalam struktur PEP_WORK_INFORMATION yang disediakan PEP dalam permintaan kerja asli. Biasanya, anggota ini menunjuk ke struktur yang berisi penunjuk ke buffer output untuk berisi hasil operasi kontrol daya yang diminta oleh PEP.

[in] BytesReturned

Ukuran, dalam byte, dari data hasil yang disimpan oleh driver di buffer output. Untuk informasi selengkapnya tentang buffer ini, lihat deskripsi anggota RequestContext .

[in] Status

Status operasi kontrol daya. Jika operasi berhasil, PEP mengatur anggota ini ke STATUS_SUCCESS. Jika tidak, PEP menetapkan anggota ini ke kode status kesalahan yang sesuai.

Keterangan

Struktur ini digunakan oleh pemberitahuan PEP_DPM_POWER_CONTROL_COMPLETE . Kelima anggota struktur berisi nilai input yang disediakan oleh

Jika buffer output terlalu kecil untuk menerima semua data hasil dari operasi, PEP mengatur anggota Status struktur ke STATUS_INSUFFICIENT_RESOURCES, mengatur anggota BytesReturned ke ukuran buffer output yang diperlukan, dan (biasanya) tidak menulis data ke buffer output.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung dimulai dengan Windows 10.
Header pep_x.h (termasuk Pep_x.h)

Lihat juga

GUID