RtlDelete 関数 (ntddk.h)
RtlDelete ルーチンは、指定されたノードを splay リンク ツリーから削除します。
構文
NTSYSAPI PRTL_SPLAY_LINKS RtlDelete(
[in] PRTL_SPLAY_LINKS Links
);
パラメーター
[in] Links
削除するノードへのポインター。 ノードは 、RtlInitializeSplayLinks を呼び出して初期化されている必要があります。
戻り値
RtlDelete は、指定されたノードが削除された splay リンク ツリーのルートへのポインターを返すか、ツリーが空の場合は NULL を 返します。
注釈
RtlDelete は、ノードが削除された後に、splay リンク ツリーを再調整します。 ツリーを再調整せずにノードを削除するには、 RtlDelete の代わりに RtlDeleteNoSplayを使用します。
Rtl スプレイ リンク ルーチンの呼び出し元は、splay リンク ツリーへのアクセスを同期する役割を担います。 高速ミューテックスは、この目的で使用する最も効率的な同期メカニズムです。
splay リンク ツリーが非ページの場合、 RtlDelete の呼び出し元は IRQL <= DISPATCH_LEVELで実行されている必要があります。 通常、呼び出し元は IRQL PASSIVE_LEVELで実行されます。
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
Header | ntddk.h (Ntddk.h、Ntifs.h を含む) |
Library | NtosKrnl.lib |
[DLL] | NtosKrnl.exe |
IRQL | 「解説」を参照してください。 |