Fungsi CmRegisterCallback (wdm.h)
Rutinitas CmRegisterCallback sudah usang untuk Windows Vista dan versi sistem operasi yang lebih baru. Gunakan CmRegisterCallbackEx sebagai gantinya.
Rutinitas CmRegisterCallback mendaftarkan rutinitas RegistryCallback .
Sintaks
NTSTATUS CmRegisterCallback(
[in] PEX_CALLBACK_FUNCTION Function,
[in, optional] PVOID Context,
[out] PLARGE_INTEGER Cookie
);
Parameter
[in] Function
Penunjuk ke rutinitas RegistryCallback untuk mendaftar.
[in, optional] Context
Nilai yang ditentukan driver yang akan diteruskan manajer konfigurasi sebagai parameter CallbackContext ke rutinitas RegistryCallback
[out] Cookie
Pointer ke variabel LARGE_INTEGER yang menerima nilai yang mengidentifikasi rutinitas panggilan balik. Saat Anda membatalkan pendaftaran rutinitas panggilan balik, teruskan nilai ini sebagai parameter Cookie ke CmUnRegisterCallback.
Nilai kembali
CmRegisterCallback mengembalikan STATUS_SUCCESS jika operasi berhasil atau kode kesalahan NTSTATUS yang sesuai jika gagal.
Keterangan
Rutinitas CmRegisterCallback tersedia pada Windows XP dan versi sistem operasi yang lebih baru. Untuk Windows Vista dan versi sistem operasi yang lebih baru, Anda harus menggunakan CmRegisterCallbackEx sebagai gantinya.
Driver memanggil CmRegisterCallback untuk mendaftarkan rutinitas RegistryCallback , yang dipanggil setiap kali utas melakukan operasi pada registri.
Panggil CmUnRegisterCallback untuk membatalkan pendaftaran rutinitas panggilan balik yang terdaftar di CmRegisterCallback .
Untuk informasi selengkapnya tentang cmRegisterCallback dan memfilter operasi registri, lihat Memfilter Panggilan Registri.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows XP dan versi Windows yang lebih baru. |
| Target Platform | Universal |
| Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <=APC_LEVEL |
| Aturan kepatuhan DDI | HwStorPortProhibitedDDIs(storport), IrqlExApcLte2(wdm) |