共用方式為


RtlInsertAsRightChild 函式 (ntddk.h)

RtlInsertAsRightChild 例程會將指定的 splay 連結插入樹狀結構中,做為該樹中指定節點的右子系。

語法

void RtlInsertAsRightChild(
  [in] PRTL_SPLAY_LINKS ParentLinks,
  [in] PRTL_SPLAY_LINKS ChildLinks
);

參數

[in] ParentLinks

樹狀結構中 ChildLinks 的節點指標應該插入為正確的子系。

[in] ChildLinks

要插入樹狀結構之splay連結節點的指標。 節點必須藉由呼叫 RtlInitializeSplayLinks來初始化。

傳回值

沒有

言論

RtlInsertAsRightChild 的呼叫者負責符合下列準則:

  • ParentLinks 的節點不得具有正確的子系。

    呼叫端可以藉由呼叫 RtlRightChild來判斷節點是否已經有正確的子系。 如果 RtlRightChild 傳回 NULL ,則 ParentLinksRtlInsertAsRightChild的有效參數。

  • ChildLinks 的節點不得有父代。

    呼叫端可以藉由呼叫 RtlIsRootRtlParent來判斷這個節點是否已經有父系。 如果以 ChildLinks呼叫時,RtlIsRoot回 true,則 ChildLinksRtlInsertAsRightChild的有效參數。 如果 RtlParent 傳回 ChildLinks的對等指標,則 ChildLinks 也是 RtlInsertAsRightChild的有效參數。

Rtl splay 連結例程的呼叫端負責同步處理對 splay 連結樹狀結構的存取。 快速 Mutex 是用於此用途的最有效率的同步處理機制。

RtlInsertAsRightChild 的呼叫者必須在 IRQL <= DISPATCH_LEVEL,如果 splay 連結樹狀目錄和 ChildLinks 節點為非分頁,則必須在 IRQL 執行。 呼叫端通常會在 IRQL PASSIVE_LEVEL執行。

要求

要求 價值
目標平臺 桌面
標頭 ntddk.h (include Ntddk.h, Ntifs.h)
IRQL 請參閱一節。

另請參閱

RtlInitializeSplayLinks

RtlInsertAsLeftChild

RtlIsRoot

RtlParent

RtlRightChild

RtlSplay