Funzione RtlSubtreeSuccessor (ntddk.h)

La routine RtlSubtreeSuccessor restituisce un puntatore al successore del nodo specificato all'interno del sottoalbero rooted in tale nodo.

Sintassi

NTSYSAPI PRTL_SPLAY_LINKS RtlSubtreeSuccessor(
  [in] PRTL_SPLAY_LINKS Links
);

Parametri

[in] Links

Puntatore al nodo. Il nodo deve essere stato inizializzato chiamando RtlInitializeSplayLinks.

Valore restituito

RtlSubtreeSuccessor restituisce un puntatore al successore del sottoalbero del nodo in Collegamentio NULL se il nodo specificato non dispone di un successore di sottoalbero.

Osservazioni

Se il nodo in Links ha un sottoalbero destro, il nodo più a sinistra di tale sottoalbero è il successore del sottoalbero.

I chiamanti della Rtl routine di collegamento splay sono responsabili della sincronizzazione dell'accesso all'albero dei collegamenti splay. Un mutex veloce è il meccanismo di sincronizzazione più efficiente da usare a questo scopo.

I chiamanti di RtlSubtreeSuccessor devono essere in esecuzione in IRQL <= DISPATCH_LEVEL se l'albero non è di pagina. Se viene eseguito il paging dell'albero, i chiamanti devono essere in esecuzione in irQL < DISPATCH_LEVEL. In genere i chiamanti vengono eseguiti in PASSIVE_LEVEL IRQL.

Fabbisogno

Requisito Valore
client minimo supportato Questa routine è disponibile in Microsoft Windows 2000 e versioni successive.
piattaforma di destinazione Universale
intestazione ntddk.h (include Ntddk.h, Ntifs.h)
libreria NtosKrnl.lib
dll NtosKrnl.exe
IRQL Vedere la sezione Osservazioni.

Vedere anche

RtlInitializeSplayLinks

RtlRealSuccessor

RtlSplay

RtlSubtreePredecessor