Fungsi panggilan balik PEPCALLBACKNOTIFYDPM (pepfx.h)

  • Artikel

Rutinitas panggilan balik peristiwa AcceptDeviceNotification menangani pemberitahuan manajemen daya perangkat (DPM) dari kerangka kerja manajemen daya Windows (PoFx).

Sintaks

PEPCALLBACKNOTIFYDPM Pepcallbacknotifydpm;

BOOLEAN Pepcallbacknotifydpm(
  [in]                ULONG Notification,
  [in, out, optional] PVOID Data
)
{...}

Parameter

[in] Notification

ID pemberitahuan DPM. Parameter ini menentukan jenis pemberitahuan DPM yang dikirim PoFx. Untuk daftar ID pemberitahuan DPM, lihat Pemberitahuan manajemen daya perangkat (DPM).

[in, out, optional] Data

Penunjuk ke struktur yang dialokasikan PoFx yang berisi data input dan/atau output untuk pemberitahuan ini. Jenis struktur ini tergantung pada ID pemberitahuan yang ditentukan oleh Pemberitahuan. Untuk daftar jenis struktur yang ditentukan untuk berbagai ID pemberitahuan DPM, lihat Pemberitahuan manajemen daya perangkat (DPM).

Nilai kembali

Rutinitas AcceptDeviceNotification harus mengembalikan TRUE jika menangani pemberitahuan, atau FALSE jika tidak.

Keterangan

Rutinitas ini diimplementasikan oleh plug-in ekstensi platform (PEP) untuk perangkat. Anggota AcceptDeviceNotification dari struktur PEP_INFORMATION adalah penunjuk ke rutinitas AcceptDeviceNotification . PEP memanggil rutinitas PoFxRegisterPlugin atau PoFxRegisterPluginEx untuk mendaftarkan rutinitas AcceptDeviceNotification PEP dengan PoFx.

PoFx memanggil rutinitas ini untuk mengirim pemberitahuan DPM ke PEP. Dalam panggilan ini, parameter Pemberitahuan menentukan jenis pemberitahuan, dan parameter Data menunjuk ke struktur data jenis yang terkait dengan pemberitahuan ini. Untuk daftar ID pemberitahuan DPM dan jenis struktur terkaitnya, lihat Pemberitahuan manajemen daya perangkat (DPM).

Pemberitahuan DPM menginformasikan PEP tentang berbagai sistem, perangkat, atau peristiwa tingkat komponenÂ, atau meneruskan permintaan dari driver perangkat ke PEP.

Rutinitas AcceptDeviceNotification tidak harus menerima setiap permintaan dari driver perangkat—misalnya, dapat mengabaikan petunjuk residensi yang menganggur. Namun, PEP harus memahami dan menerima sebagian besar pemberitahuan manajemen daya perangkat bahkan jika PEP memilih untuk tidak bertindak atasnya. PEP harus menolak untuk menangani (dengan mengembalikan FALSE) setiap pemberitahuan yang tidak dikenalinya.

Rutinitas AcceptDeviceNotification dapat dipanggil di IRQL <= DISPATCH_LEVEL. IRQL tempat rutinitas AcceptAcpiNotification PEP disebut bervariasi sesuai dengan jenis pemberitahuan yang sedang dikirim. Jenis pemberitahuan ditentukan oleh parameter Pemberitahuan . Untuk informasi selengkapnya, lihat halaman referensi individual di bawah Pemberitahuan manajemen daya perangkat (DPM).

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung dimulai dengan Windows 10.
Target Platform Windows
Header pepfx.h (termasuk Pep_x.h)
IRQL <= DISPATCH_LEVEL

Lihat juga

PEP_INFORMATION

PoFxRegisterPlugin

PoFxRegisterPluginEx