struktur PEP_REGISTER_DEVICE_V2 (pepfx.h)

Artikel
08/07/2023

Struktur PEP_REGISTER_DEVICE_V2 menjelaskan perangkat yang tumpukan drivernya baru saja terdaftar dengan kerangka kerja manajemen daya Windows (PoFx).

Sintaks

typedef struct _PEP_REGISTER_DEVICE_V2 {
  [in]  PCUNICODE_STRING           DeviceId;
  [in]  POHANDLE                   KernelHandle;
  [in]  PPEP_DEVICE_REGISTER_V2    Register;
  [out] PEPHANDLE                  DeviceHandle;
  [out] PEP_DEVICE_ACCEPTANCE_TYPE DeviceAccepted;
} PEP_REGISTER_DEVICE_V2, *PPEP_REGISTER_DEVICE_V2;

Anggota

[in] DeviceId

String yang secara unik mengidentifikasi perangkat. Anggota ini adalah penunjuk ke struktur UNICODE_STRING yang berisi string identifikasi perangkat.

[in] KernelHandle

Nilai POHANDLE yang mewakili pendaftaran perangkat dengan PoFx. Plug-in ekstensi platform (PEP) sebelumnya menerima handel ini dari PoFx selama pemberitahuan PEP_DPM_REGISTER_DEVICE yang memberi tahu PEP bahwa tumpukan driver perangkat mendaftarkan perangkat dengan PoFx.

[in] Register

Penunjuk ke struktur PEP_DEVICE_REGISTER_V2 yang menjelaskan atribut manajemen daya dari semua komponen di perangkat. Untuk informasi selengkapnya, lihat Keterangan.

[out] DeviceHandle

Nilai PEPHANDLE yang dibuat PEP untuk mengidentifikasi perangkat ini. PoFx akan menggunakan handel ini untuk mengidentifikasi perangkat dalam pemberitahuan Manajemen daya perangkat (DPM) di masa mendatang.

[out] DeviceAccepted

Nilai enumerasi PEP_DEVICE_ACCEPTANCE_TYPE yang menunjukkan apakah PEP mengklaim kepemilikan perangkat. PEP yang mengklaim kepemilikan bertanggung jawab untuk menangani pemberitahuan DPM untuk perangkat.

Keterangan

Struktur ini digunakan oleh pemberitahuan PEP_DPM_REGISTER_DEVICE . Tiga anggota pertama dari struktur ini berisi nilai input yang disediakan oleh PoFx. Dua anggota terakhir berisi nilai output yang ditulis PEP ke struktur sebagai respons terhadap pemberitahuan ini.

Anggota Daftar berisi penunjuk ke buffer input yang dialokasikan oleh PoFx. PoFx menulis struktur PEP_DEVICE_REGISTER_V2 dan data terkait ke struktur ini sebelum mengirim pemberitahuan PEP_DPM_REGISTER_DEVICE ke PEP. Konten buffer ini tetap valid hanya sampai PEP selesai menangani pemberitahuan dan kembali dari callback AcceptDeviceNotification .