Fungsi CmRegisterCallbackEx (wdm.h)

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 ketinggiandriver 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

CmRegisterCallback

CmUnRegisterCallback

DRIVER_OBJECT

RegistryCallback

UNICODE_STRING