Fungsi CmRegisterCallback (wdm.h)

  • Artikel

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)

Lihat juga

CmRegisterCallbackEx

CmUnRegisterCallback

RegistryCallback