KeInitializeQueue 関数 (ntifs.h)

[アーティクル]
02/27/2024

KeInitializeQueue ルーチンは、スレッドがエントリを待機できるキューオブジェクトを初期化します。

構文

void KeInitializeQueue(
  [out] PRKQUEUE Queue,
  [in]  ULONG    Count
);

パラメーター

[out] Queue

呼び出し元が非ページプールに常駐ストレージを提供する必要がある KQUEUE 構造体へのポインター。この構造体は次のように定義されます。

typedef struct _KQUEUE {
    DISPATCHER_HEADER Header;
    LIST_ENTRY EntryListHead;
    ULONG CurrentCount;
    ULONG MaximumCount;
    LIST_ENTRY ThreadListHead;
} KQUEUE, *PKQUEUE, *RESTRICTED_POINTER PRKQUEUE;

メンバー	意味
Header	キューヘッダー。
EntryListHead	キュー内の最初のエントリへのポインター。
CurrentCount	キューで待機しているスレッドの現在の数。
MaximumCount	キューが待機を満たすことができる同時実行スレッドの最大数。
ThreadListHead	スレッドリスト内の最初のエントリへのポインター。

[in] Count

キューオブジェクトで待機するスレッドの最大数を同時に満たすことができます。このパラメーターを指定しない場合は、コンピューター内のプロセッサの数が使用されます。

戻り値

なし

解説

通常、 KeInitializeQueue の呼び出し元は、キューに登録し、そのエントリをデキューする専用スレッドのセットも作成します。このような呼び出し元は、明示的な Count を 指定して、専用スレッドの多くがキューオブジェクトで同時に待機するのを防ぐことができます。

KeInitializeQueue は、キューオブジェクトの初期シグナル状態を Not Signaled に設定します。

ドライバーで管理された内部キューの使用の詳細については、「ドライバーマネージド IRP キュー」を参照してください。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL