Fungsi RtlDeleteElementGenericTableAvl (ntddk.h)

  • Artikel

Rutinitas RtlDeleteElementGenericTableAvl menghapus elemen dari tabel generik.

Sintaks

NTSYSAPI BOOLEAN RtlDeleteElementGenericTableAvl(
  [in] PRTL_AVL_TABLE Table,
  [in] PVOID          Buffer
);

Parameter

[in] Table

Penunjuk ke tabel generik (RTL_AVL_TABLE). Tabel harus telah diinisialisasi dengan memanggil RtlInitializeGenericTableAvl.

[in] Buffer

Penunjuk ke buffer yang dialokasikan penelepon yang berisi nilai yang secara unik mengidentifikasi elemen yang akan dihapus.

Nilai kembali

RtlDeleteElementGenericTableAvl mengembalikan TRUE jika elemen berhasil dihapus, FALSE jika tidak.

Keterangan

RtlDeleteElementGenericTableAvl memanggil CompareRoutine dan FreeRoutine yang terdaftar dalam panggilan ke RtlInitializeGenericTableAvl.

Secara default, sistem operasi menggunakan pohon splay untuk mengimplementasikan tabel generik, tetapi rutinitas RtlDeleteElementGenericTableAvl hanya berfungsi dengan pohon Adelson-Velsky/Landis (AVL). Untuk mengonfigurasi rutinitas tabel generik untuk menggunakan pohon AVL alih-alih pohon splay di driver Anda, masukkan pernyataan definisi berikut dalam file header umum sebelum menyertakan Ntddk.h:

#define RTL_USE_AVL_TABLES 0

Jika RTL_USE_AVL_TABLES tidak ditentukan, Anda harus menggunakan formulir AVL dari rutinitas tabel generik. Misalnya, gunakan rutinitas RtlDeleteElementGenericTableAvl alih-alih RtlDeleteElementGenericTable. Dalam panggilan ke RtlDeleteElementGenericTableAvl, pemanggil harus meneruskan struktur tabel RTL_AVL_TABLE daripada RTL_GENERIC_TABLE.

Penelepon Rtl.. Rutinitas GenericTableAvl bertanggung jawab untuk menyinkronkan akses secara eksklusif ke tabel generik. Mutex cepat eksklusif adalah mekanisme sinkronisasi yang paling efisien untuk digunakan untuk tujuan ini.

Penelepon RtlDeleteElementGenericTableAvl harus berjalan di IRQL < DISPATCH_LEVEL jika salah satu kondisi berikut berlaku:

  • Memori yang dialokasikan pemanggil di Tabel atau di Buffer dapat di-pageable.
  • CompareRoutine atau FreeRoutine yang disediakan penelepon berisi kode yang dapat dipaginasi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows XP.
Target Platform Universal
Header ntddk.h (termasuk Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Lihat bagian Keterangan.

Lihat juga

RtlInitializeGenericTableAvl

RtlInsertElementGenericTableAvl