RtlEnumerateGenericTableWithoutSplayingAvl 函式 (ntddk.h)

發行項
02/26/2024

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 會傳回與專案相關聯的呼叫端定義結構指標。如果 RestartKey 為 NULL 且數據表沒有元素，或者 RestartKey 是傳回的指標，而且沒有下一個專案，則會傳回 NULL。

備註

RtlEnumerateGenericTableWithoutSplayingAvl 例程實際上無法搭配 splay 樹狀結構使用，但提供類似名稱的例程與 RtlEnumerateGenericTableWithoutSplayingAvl。

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

根據預設，操作系統會使用 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如果泛型數據表的呼叫端配置記憶體可分頁。