Fungsi CmRegisterCallbackEx (wdm.h)

Artikel
02/27/2024

Rutinitas CmRegisterCallbackEx mendaftarkan rutinitas RegistryCallback .

Sintaks

NTSTATUS CmRegisterCallbackEx(
  [in]           PEX_CALLBACK_FUNCTION Function,
  [in]           PCUNICODE_STRING      Altitude,
  [in]           PVOID                 Driver,
  [in, optional] PVOID                 Context,
  [out]          PLARGE_INTEGER        Cookie,
                 PVOID                 Reserved
);

Parameter

[in] Function

Penunjuk ke rutinitas RegistryCallback untuk mendaftar.

[in] Altitude

Penunjuk ke struktur UNICODE_STRING . Struktur ini harus berisi string yang mewakili ketinggian driver minifilter panggilan. Untuk informasi selengkapnya, lihat Keterangan.

[in] Driver

Penunjuk ke struktur DRIVER_OBJECT yang mewakili driver.

[in, optional] Context

Nilai yang ditentukan driver yang akan diteruskan manajer konfigurasi sebagai parameter CallbackContext ke rutinitas RegistryCallback .

[out] Cookie

Penunjuk 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.

Reserved

Parameter ini dicadangkan untuk digunakan di masa mendatang.

Nilai kembali

CmRegisterCallbackEx mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, rutinitas ini mungkin mengembalikan salah satu nilai NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_FLT_INSTANCE_ALTITUDE_COLLISION	Driver panggilan atau driver lain telah mendaftarkan rutinitas RegistryCallback untuk ketinggian yang ditentukan.
STATUS_INSUFFICIENT_RESOURCES	Upaya untuk mengalokasikan memori gagal.

Keterangan

Rutinitas CmRegisterCallbackEx tersedia dimulai dengan Windows Vista.

Driver dapat memanggil CmRegisterCallback atau CmRegisterCallbackEx untuk mendaftarkan rutinitas RegistryCallback , yang disebut setiap kali utas melakukan operasi pada registri.

Parameter Ketinggian menentukan posisi driver minifilter relatif terhadap minifilter lain di tumpukan I/O saat minifilter dimuat. Alokasi ketinggian ke minifilter dikelola oleh Microsoft. Untuk informasi selengkapnya tentang ketinggian, lihat Memuat Grup Pesanan dan Ketinggian untuk Driver Minifilter.

Panggil CmUnRegisterCallback untuk membatalkan pendaftaran rutinitas panggilan balik yang terdaftar di CmRegisterCallbackEx .

Untuk informasi selengkapnya tentang CmRegisterCallbackEx dan memfilter operasi registri, lihat Memfilter Panggilan Registri.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows Vista.
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

Bagikan melalui