RtlNumberGenericTableElementsAvl 関数 (ntddk.h)
RtlNumberGenericTableElementsAvl ルーチンは、ジェネリック テーブル内の要素の数を返します。
構文
NTSYSAPI ULONG RtlNumberGenericTableElementsAvl(
[in] PRTL_AVL_TABLE Table
);
パラメーター
[in] Table
汎用テーブルへのポインター (RTL_AVL_TABLE)。 テーブルは 、RtlInitializeGenericTableAvl を呼び出して初期化されている必要があります。
戻り値
RtlNumberGenericTableElementsAvl は、テーブルに現在格納されている要素の数を返します。
注釈
既定では、オペレーティング システムは splay ツリーを使用して汎用テーブルを実装しますが、 RtlNumberGenericTableElementsAvl ルーチンは Adelson-Velsky/Landis (AVL) ツリーでのみ機能します。 ドライバーでツリーを表示する代わりに AVL ツリーを使用するように汎用テーブル ルーチンを構成するには、 Ntddk.h を含める前に、共通ヘッダー ファイルに次の define ステートメントを挿入します。
#define RTL_USE_AVL_TABLES 0
RTL_USE_AVL_TABLESが定義されていない場合は、汎用表ルーチンの AVL 形式を使用する必要があります。 たとえば、 RtlNumberGenericTableElements の代わりに RtlNumberGenericTableElementsAvl ルーチン を使用します。 RtlNumberGenericTableElementsAvl の呼び出しでは、呼び出し元はRTL_GENERIC_TABLEではなく、RTL_AVL_TABLEテーブル構造を渡す必要があります。
Rtl の呼び出し元 。.GenericTableAvl ルーチンは、ジェネリック テーブルへのアクセスを排他的に同期する役割を担います。 排他高速ミューテックスは、この目的で使用する最も効率的な同期メカニズムです。
汎用テーブルの呼び出し元によって割り当てられたメモリがページング可能な場合、 RtlNumberGenericTableElementsAvl の呼び出し元は IRQL < DISPATCH_LEVELで実行されている必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP 以降で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ntddk.h (Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL (「解説」セクションを参照) |