Fungsi PsSetLoadImageNotifyRoutine (ntddk.h)

Rutinitas PsSetLoadImageNotifyRoutine mendaftarkan panggilan balik yang disediakan driver yang kemudian diberi tahu setiap kali gambar (misalnya, DLL atau EXE) dimuat (atau dipetakan ke dalam memori).

Sintaks

NTSTATUS PsSetLoadImageNotifyRoutine(
  [in] PLOAD_IMAGE_NOTIFY_ROUTINE NotifyRoutine
);

Parameter

[in] NotifyRoutine

Penunjuk ke rutinitas panggilan balik PLOAD_IMAGE_NOTIFY_ROUTINE yang diimplementasikan penelepon untuk pemberitahuan gambar beban.

Nilai kembali

PsSetLoadImageNotifyRoutine mengembalikan STATUS_SUCCESS atau mengembalikan STATUS_INSUFFICIENT_RESOURCES jika gagal dalam pendaftaran panggilan balik.

Keterangan

Driver pembuatan profil sistem tingkat tertinggi dapat memanggil PsSetLoadImageNotifyRoutine untuk menyiapkan rutinitas pemberitahuan gambar beban mereka (lihat PLOAD_IMAGE_NOTIFY_ROUTINE).

Jumlah maksimum driver yang dapat didaftarkan secara bersamaan untuk menerima pemberitahuan load-image adalah delapan. Jika jumlah maksimum rutinitas pemberitahuan gambar beban sudah terdaftar ketika driver memanggil PsSetLoadImageNotifyRoutine untuk mencoba mendaftarkan pemberitahuan tambahan rutin, PsSetLoadImageNotifyRoutine gagal dan mengembalikan STATUS_INSUFFICIENT_RESOURCES.

Catatan

• Pembaruan untuk Windows 8.1 meningkatkan jumlah maksimum driver yang terdaftar untuk menerima pemberitahuan load-image dari delapan menjadi 64. Pembaruan ini diinstal sebagai bagian dari pembaruan kumulatif yang tersedia melalui Windows Update mulai 8 April 2014. Selain itu, pembaruan kumulatif ini tersedia di https://support.microsoft.com/kb/2919355.
• Pengguna Windows 7 dengan Paket Layanan 1 (SP1) dapat menginstal perbaikan untuk meningkatkan jumlah maksimum driver yang terdaftar untuk menerima pemberitahuan gambar beban dari 8 menjadi 64. Perbaikan ini tersedia di https://support.microsoft.com/kb/2922790.

Driver harus menghapus panggilan balik apa pun yang didaftarkannya sebelum dibongkar. Anda dapat menghapus panggilan balik dengan memanggil rutinitas PsRemoveLoadImageNotifyRoutine .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 2000.
Target Platform	Universal
Header	ntddk.h (termasuk Ntddk.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs(storport), IrqlPsPassive(wdm), PowerIrpDDis(wdm)

Lihat juga

PLOAD_IMAGE_NOTIFY_ROUTINE

PsGetCurrentProcessId

PsRemoveLoadImageNotifyRoutine

PsSetCreateProcessNotifyRoutine

PsSetCreateThreadNotifyRoutine