Fungsi TmEnableCallbacks (wdm.h)

Rutinitas TmEnableCallbacks memungkinkan rutinitas panggilan balik yang menerima pemberitahuan transaksi.

Sintaks

NTSTATUS TmEnableCallbacks(
  [in]           PKRESOURCEMANAGER   ResourceManager,
  [in]           PTM_RM_NOTIFICATION CallbackRoutine,
  [in, optional] PVOID               RMKey
);

Parameter

[in] ResourceManager

Penunjuk ke objek resource manager. Untuk mendapatkan pointer ini, komponen Anda harus memanggil ObReferenceObjectByHandle dan menyediakan handel objek yang sebelumnya memanggil ZwCreateResourceManager atau ZwOpenResourceManager yang disediakan.

[in] CallbackRoutine

Penunjuk ke rutinitas ResourceManagerNotification .

[in, optional] RMKey

Nilai konteks yang ditentukan penelepon yang secara unik mengidentifikasi manajer sumber daya. Rutinitas ResourceManagerNotification penelepon menerima nilai ini sebagai input.

Nilai kembali

TmEnableCallbacks mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, rutinitas ini mungkin mengembalikan nilai berikut:

Menampilkan kode	Deskripsi
STATUS_UNSUCCESSFUL	Penunjuk CallbackRoutine adalah NULL.

 

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Manajer sumber daya Anda dapat memanggil TmEnableCallbacks untuk mengaktifkan rutinitas panggilan balik ResourceManagerNotification . Gunakan TmEnableCallbacks untuk mengaktifkan pemberitahuan asinkron. Gunakan ZwGetNotificationResourceManager untuk mendapatkan pemberitahuan secara sinkron.

Resource manager dapat mendaftarkan satu rutinitas panggilan balik untuk setiap objek resource manager.

Untuk informasi selengkapnya tentang rutinitas TmEnableCallbacks, lihat Membuat Resource Manager.

Untuk informasi tentang kapan harus menggunakan rutinitas TmXxx KTM alih-alih rutinitas ZwXxx , lihat Menggunakan Rutinitas TmXxx.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi sistem operasi yang lebih baru.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Lihat juga

ObReferenceObjectByHandle

ResourceManagerNotification

ZwCreateResourceManager

ZwGetNotificationResourceManager

ZwOpenResourceManager