共用方式為


RtlEnumerateGenericTableWithoutSplayingAvl 函式 (ntddk.h)

RtlEnumerateGenericTableWithoutSplayingAvl 例程是用來列舉泛型數據表中的專案。

語法

NTSYSAPI PVOID RtlEnumerateGenericTableWithoutSplayingAvl(
  [in]      PRTL_AVL_TABLE Table,
  [in, out] PVOID          *RestartKey
);

參數

[in] Table

泛型數據表的指標(RTL_AVL_TABLE)。 數據表必須藉由呼叫 RtlInitializeGenericTableAvl來初始化。

[in, out] RestartKey

上一個呼叫 RtlEnumerateGenericTableWithoutSplayingAvl所傳回之項目的位址。 如果列舉是要從數據表的第一個項目開始,則應該設定為 NULL

若要列舉數據表中的所有元素,請使用 RtlEnumerateGenericTableWithoutSplayingAvl,如下所示:

RestartKey = NULL;
for (ptr = RtlEnumerateGenericTableWithoutSplayingAvl(Table, &RestartKey);
     ptr != NULL;
     ptr = RtlEnumerateGenericTableWithoutSplayingAvl(Table, &RestartKey)) {
        // Process the element pointed to by ptr
}

傳回值

RtlEnumerateGenericTableWithoutSplayingAvl 會傳回與 專案相關聯之呼叫端定義結構的指標。 如果 RestartKeyNULL 且數據表沒有元素,或是 RestartKey 為傳回的指標,而且沒有下一個專案,它會傳回 NULL NULL。

言論

RtlEnumerateGenericTableWithoutSplayingAvl 可以重複呼叫,以處理泛型數據表每個元素中的呼叫端數據。

傳回的順序會傳回元素,由提供給 RtlInitializeGenericTableAvlPRTL_AVL_COMPARE_ROUTINE 參數所定義。

根據預設,作系統會使用 splay 樹狀結構來實作泛型數據表,但 RtlLookupElementGenericTableFullAvl 例程只適用於 Adelson-Velsky/Landis (AVL) 樹狀結構。 若要將泛型數據表例程設定為使用AVL樹狀結構,而不是驅動程式中的splay樹狀結構,請在包含 Ntddk.h之前,在通用頭檔中插入下列 define 語句:

#define RTL_USE_AVL_TABLES 0

如果未定義RTL_USE_AVL_TABLES,您必須使用泛型數據表例程的AVL形式。 例如,使用 RtlEnumerateGenericTableWithoutSplayingAvl 例程,而不是 RtlEnumerateGenericTableWithoutSplaying。 在呼叫 RtlEnumerateGenericTableWithoutSplayingAvl中,呼叫端必須傳遞 RTL_AVL_TABLE 數據表結構,而不是 RTL_GENERIC_TABLE

* Rtl.的呼叫端。GenericTableAvl* 例程負責獨佔同步處理泛型數據表的存取權。 獨佔快速 Mutex 是用於此用途的最有效率的同步處理機制。

RtlEnumerateGenericTableWithoutSplayingAvl 的呼叫端必須在 IRQL < DISPATCH_LEVEL,如果泛型數據表的呼叫端配置記憶體可分頁。

要求

要求 價值
目標平臺 普遍
標頭 ntddk.h (include Ntddk.h, Ntifs.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 請參閱一節。

另請參閱

RtlEnumerateGenericTableAvl

RtlInitializeGenericTableAvl

RtlIsGenericTableEmptyAvl

RtlNumberGenericTableElementsAvl