Fungsi PoFxRegisterPluginEx (pepfx.h)

  • Artikel

Rutinitas PoFxRegisterPluginEx mendaftarkan plug-in ekstensi platform (PEP) dengan kerangka kerja manajemen daya Windows (PoFx).

Sintaks

NTSTATUS PoFxRegisterPluginEx(
  [in]      PPEP_INFORMATION        PepInformation,
  [in]      ULONGLONG               Flags,
  [in, out] PPEP_KERNEL_INFORMATION KernelInformation
);

Parameter

[in] PepInformation

Penunjuk ke struktur PEP_INFORMATION yang berisi pointer ke satu atau beberapa rutinitas panggilan balik yang diimplementasikan oleh PEP. Rutinitas ini menangani pemberitahuan yang dikirim ke PEP oleh PoFx.

[in] Flags

Sekumpulan bit bendera untuk mengonfigurasi antarmuka PEP. Atur anggota ini ke nol atau ke nilai berikut.

Bit bendera Deskripsi
PEP_FLAG_WORKER_CONCURRENCY

[in, out] KernelInformation

Penunjuk ke struktur PEP_KERNEL_INFORMATION .

Nilai kembali

PoFxRegisterPluginEx mengembalikan STATUS_SUCCESS jika panggilan berhasil mendaftarkan PEP. Kemungkinan nilai pengembalian kesalahan menyertakan kode status berikut.

Mengembalikan nilai Deskripsi
STATUS_INVALID_PARAMETER
 Anggota Versi atau Ukuran struktur PEP_KERNEL_INFORMATION diatur ke nilai yang tidak valid; atau anggota AcceptDeviceNotification dari struktur ini diatur ke NULL.
STATUS_INVALID_PEP_INFO_VERSION
 Anggota versi struktur PEP_INFORMATION diatur ke nilai yang tidak valid.
STATUS_INSUFFICIENT_RESOURCES
 Tidak dapat mengalokasikan sumber daya yang diperlukan untuk menyelesaikan pendaftaran yang diminta.

Keterangan

PEP memanggil rutinitas ini untuk mendaftarkan dirinya dengan PoFx.

PEP tidak dapat membatalkan pendaftaran, dan tidak dapat mendaftar dua kali. Jika PEP harus diservis, sistem operasi harus dimulai ulang.

Rutinitas PoFxRegisterPlugin mirip dengan PoFxRegisterPluginEx, kecuali bahwa itu tidak mengambil parameter Flags .

PEP harus memanggil PoFxRegisterPluginEx di IRQL = PASSIVE_LEVEL.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 10.
Target Platform Windows
Header pepfx.h (termasuk Pep_x.h)
Pustaka Ntoskrnl.lib
IRQL PASSIVE_LEVEL

Lihat juga

PEP_INFORMATION

PEP_KERNEL_INFORMATION

PoFxRegisterPlugin