(ntddk.h) RtlDelete 函式
RtlDelete 例程會從splay連結樹狀結構中刪除指定的節點。
語法
NTSYSAPI PRTL_SPLAY_LINKS RtlDelete(
[in] PRTL_SPLAY_LINKS Links
);
參數
[in] Links
要刪除之節點的指標。 節點必須透過呼叫 RtlInitializeSplayLinks 來初始化。
傳回值
RtlDelete 會傳回刪除指定節點之 splay 鏈接樹狀結構根目錄的指標,如果樹狀結構是空的,則會傳回 NULL 。
備註
RtlDelete 會在刪除節點之後重新平衡 splay 連結樹狀結構。 若要刪除節點而不重新平衡樹狀結構,請使用 RtlDeleteNoSplay ,而不是 RtlDelete。
Rtl splay 連結例程的呼叫端負責同步存取 splay 連結樹狀結構。 快速 Mutex 是用於此用途的最有效率同步處理機制。
如果 Splay 連結樹狀結構為非分頁, 則 RtlDelete 的呼叫端必須在 IRQL <= DISPATCH_LEVEL執行。 呼叫端通常會在 IRQL PASSIVE_LEVEL上執行。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | ntddk.h (包含 Ntddk.h、Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | 請參閱一節。 |