Fungsi RtlRealSuccessor (ntddk.h)

Rutinitas RtlRealSuccessor mengembalikan penunjuk ke penerus simpul yang ditentukan di pohon tautan splay.

Sintaks

NTSYSAPI PRTL_SPLAY_LINKS RtlRealSuccessor(
  [in] PRTL_SPLAY_LINKS Links
);

Parameter

[in] Links

Arahkan ke simpul. Node harus telah diinisialisasi dengan memanggil RtlInitializeSplayLinks.

Nilai kembali

RtlRealSuccessor mengembalikan penunjuk ke penerus simpul di Tautan, atau NULL jika simpul tidak memiliki penerus.

Keterangan

Penerus nyata dari simpul tertentu ditentukan sebagai berikut:

• Jika simpul yang diberikan memiliki subtree kanan, simpul paling kiri di subtree kanan simpul di Links adalah penerusnya. Perhatikan bahwa RtlSubtreeSuccessor mengembalikan hasil yang sama untuk kasus ini.
• Jika tidak, simpul leluhur terdekat, di mana simpul yang diberikan adalah turunan subtree kiri, adalah penerusnya.

Pemanggil rutinitas tautan splay Rtl bertanggung jawab untuk menyinkronkan akses ke pohon tautan splay. Mutex cepat adalah mekanisme sinkronisasi yang paling efisien untuk digunakan untuk tujuan ini.

Pemanggil RtlRealSuccessor harus berjalan di IRQL <= DISPATCH_LEVEL jika pohon tidak dipagasi. Biasanya, penelepon berjalan di IRQL PASSIVE_LEVEL.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Rutinitas ini tersedia di Microsoft Windows 2000 dan yang lebih baru.
Target Platform	Universal
Header	ntddk.h (termasuk Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Lihat bagian Keterangan.

Lihat juga

RtlRealPredecessor

RtlSplay

RtlSubtreeSuccessor