Funzione RtlSubtreeSuccessor (ntddk.h)
La routine RtlSubtreeSuccessor restituisce un puntatore al successore del nodo specificato all'interno del sottoalbero radicato in quel 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 Links o NULL se il nodo specificato non ha un successore di sottoalbero.
Commenti
Se il nodo in Links ha un sottoalbero destro, il nodo più sinistro di tale sottoalbero è il successore di sottoalbero.
I chiamanti delle routine di collegamento Splay Rtl sono responsabili della sincronizzazione dell'accesso all'albero dei collegamenti splay. Un mutex veloce è il meccanismo di sincronizzazione più efficiente da usare per questo scopo.
I chiamanti di RtlSubtreeSuccessor devono essere in esecuzione in IRQL <= DISPATCH_LEVEL se l'albero non è in pagina. Se l'albero viene paginato, i chiamanti devono essere in esecuzione in irQL < DISPATCH_LEVEL. In genere i chiamanti vengono eseguiti in irQL PASSIVE_LEVEL.
Requisiti
| 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. |