RtlNumberGenericTableElements 函式 (ntddk.h)

RtlNumberGenericTableElements常式會傳回泛型資料表中的元素數目。

語法

NTSYSAPI ULONG RtlNumberGenericTableElements(
  [in] PRTL_GENERIC_TABLE Table
);

參數

[in] Table

泛型資料表的指標 (RTL_GENERIC_TABLE) 。 資料表必須已藉由呼叫 RtlInitializeGenericTable來初始化。

傳回值

RtlNumberGenericTableElements 會傳回目前儲存在資料表中的元素數目。

備註

Rtl 的呼叫端。GenericTable常式負責獨佔同步處理泛型資料表的存取。 獨佔快速 Mutex 是用於此用途的最有效率同步處理機制。

根據預設,作業系統會使用 splay 樹狀架構來實作泛型資料表。 在某些情況下,Splay 樹狀結構上的作業會讓樹狀結構深而窄,甚至可能會變成直線。 非常深的樹狀結構會降低搜尋的效能。 您可以使用 Adelson-Velsky/Landis (AVL) 樹狀結構,確保泛型資料表的更平衡、淺層樹狀結構實作。 如果您想要將泛型資料表常式設定為使用 AVL 樹狀結構,而不是驅動程式中的 splay 樹狀結構,請在包含 Ntddk.h之前,先在通用標頭檔中插入下列 define 語句:

#define RTL_USE_AVL_TABLES 0

如果未定義RTL_USE_AVL_TABLES,您必須使用泛型資料表常式的 AVL 格式。 例如,使用 RtlNumberGenericTableElementsAvl 常式,而不是 RtlNumberGenericTableElements。 在 對 RtlNumberGenericTableElementsAvl 的呼叫中,呼叫端必須傳遞 RTL_AVL_TABLE 資料表結構,而不是 RTL_GENERIC_TABLE

如果泛型資料表的呼叫端配置記憶體可分頁, 則 RtlNumberGenericTableElements 的呼叫端必須在 IRQL < DISPATCH_LEVEL執行。

規格需求

   
目標平臺 環球
標頭 ntddk.h (包含 Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL (請參閱一節)

另請參閱

RtlInitializeGenericTable

RtlIsGenericTableEmpty