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 | 請參閱一節。 |