struktur PEP_POWER_CONTROL_REQUEST (pepfx.h)

  • Artikel

Struktur PEP_POWER_CONTROL_REQUEST berisi permintaan dari driver untuk operasi kontrol daya.

Sintaks

typedef struct _PEP_POWER_CONTROL_REQUEST {
  [in]  PEPHANDLE DeviceHandle;
  [in]  LPCGUID   PowerControlCode;
  [in]  PVOID     InBuffer;
  [in]  SIZE_T    InBufferSize;
  [in]  PVOID     OutBuffer;
  [in]  SIZE_T    OutBufferSize;
  [out] SIZE_T    BytesReturned;
  [out] NTSTATUS  Status;
} PEP_POWER_CONTROL_REQUEST, *PPEP_POWER_CONTROL_REQUEST;

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 akan dilakukan. Ini adalah nilai yang sama dengan driver yang meminta yang disediakan sebagai parameter PowerControlCode ke rutinitas PoFxPowerControl .

[in] InBuffer

Penunjuk ke buffer input yang dialokasikan driver yang berisi parameter input untuk operasi kontrol daya ini. Ini adalah nilai yang sama dengan driver yang meminta yang disediakan sebagai parameter InBuffer ke rutinitas PoFxPowerControl .

[in] InBufferSize

Ukuran dalam byte buffer yang ditujukkan oleh InBuffer. Ini adalah nilai yang sama dengan driver yang meminta yang disediakan sebagai parameter InBufferSize ke rutinitas PoFxPowerControl .

[in] OutBuffer

Penunjuk ke buffer output yang dialokasikan driver tempat PEP menulis hasil operasi kontrol daya ini. Ini adalah nilai yang sama dengan driver yang meminta yang disediakan sebagai parameter OutBuffer ke rutinitas PoFxPowerControl .

[in] OutBufferSize

Ukuran dalam byte buffer yang diacu oleh OutBuffer.

[out] BytesReturned

Jumlah byte yang ditulis PEP ke buffer output yang ditujukkan oleh OutBuffer.

[out] Status

Status operasi kontrol daya yang diminta. 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_REQUEST . Enam anggota pertama struktur berisi nilai input yang disediakan oleh Windows power management Framework (PoFx). Dua anggota terakhir berisi nilai yang ditulis PEP ke struktur sebagai respons terhadap pemberitahuan ini. Selain itu, PEP menulis ke buffer output yang ditujukkan oleh anggota OutBuffer .

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.

Driver untuk perangkat dapat memanggil rutinitas PoFxPowerControl untuk meminta operasi kontrol daya pada perangkat. Selama panggilan ini, PoFx mendelegasikan penanganan permintaan ini ke PEP yang memiliki perangkat. Anggota PowerControlCode dari struktur PEP_POWER_CONTROL_REQUEST berisi kode kontrol kustom yang maknanya dipahami oleh driver dan PEP untuk perangkat.

Persyaratan

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

Lihat juga

PEP_DPM_POWER_CONTROL_REQUEST

PEP_DPM_REGISTER_DEVICE

PoFxPowerControl