Fungsi ObRegisterCallbacks (wdm.h)

  • Artikel

Rutinitas ObRegisterCallbacks mendaftarkan daftar rutinitas panggilan balik untuk operasi utas, proses, dan handel desktop.

Sintaks

NTSTATUS ObRegisterCallbacks(
  [in]  POB_CALLBACK_REGISTRATION CallbackRegistration,
  [out] PVOID                     *RegistrationHandle
);

Parameter

[in] CallbackRegistration

Penunjuk ke struktur OB_CALLBACK_REGISTRATION yang menentukan daftar rutinitas panggilan balik dan informasi pendaftaran lainnya.

[out] RegistrationHandle

Penunjuk ke variabel yang menerima nilai yang mengidentifikasi kumpulan rutinitas panggilan balik terdaftar. Penelepon meneruskan nilai ini ke rutinitas ObUnRegisterCallbacks untuk membatalkan pendaftaran set panggilan balik.

Nilai kembali

ObRegisterCallbacks mengembalikan nilai NTSTATUS. Rutinitas ini mungkin mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Rutinitas panggilan balik yang ditentukan terdaftar di sistem.
STATUS_FLT_INSTANCE_ALTITUDE_COLLISION
 Driver panggilan atau driver lain telah mendaftarkan rutinitas panggilan balik untuk ketinggian yang ditentukan CallBackRegistration->Altitude . Untuk informasi selengkapnya tentang ketinggian ini, lihat deskripsi anggota Ketinggian di OB_CALLBACK_REGISTRATION.
STATUS_INVALID_PARAMETER
 Satu atau beberapa parameter yang ditentukan dalam pendaftaran tidak valid. ObRegisterCallbacks mungkin mengembalikan kesalahan ini, misalnya, jika nilai yang tidak valid untukVersiCallBackRegistration-> ditentukan atau jika pendaftaran dicoba untuk jenis objek yang tidak mendukung rutinitas panggilan balik.
STATUS_ACCESS_DENIED
 Rutinitas panggilan balik tidak berada dalam gambar biner kernel yang ditandatangani.
STATUS_INSUFFICIENT_RESOURCES
 Upaya untuk mengalokasikan memori gagal.

Keterangan

Driver harus membatalkan pendaftaran semua rutinitas panggilan balik sebelum dibongkar. Anda dapat membatalkan pendaftaran rutinitas panggilan balik dengan memanggil rutinitas ObUnRegisterCallbacks .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows Vista dengan Paket Layanan 1 (SP1) dan Windows Server 2008.
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Lihat juga

OB_CALLBACK_REGISTRATION

ObUnRegisterCallbacks