KeInitializeSemaphore 関数 (wdm.h)

KeInitializeSemaphore ルーチンは、指定されたカウントを使用してセマフォオブジェクトを初期化し、カウントで取得できる上限を指定します。

構文

void KeInitializeSemaphore(
  [out] PRKSEMAPHORE Semaphore,
  [in]  LONG         Count,
  [in]  LONG         Limit
);

[out] Semaphore

呼び出し元がストレージを提供する、セマフォ型のディスパッチャーオブジェクトへのポインター。

[in] Count

セマフォに割り当てる初期カウント値を指定します。必ず正の値を指定します。 0 以外の値を指定すると、セマフォの初期状態が signaled に設定されます。

[in] Limit

セマフォが取得できる最大カウント値を指定します。必ず正の値を指定します。セマフォがシグナル状態に設定され、セマフォが保護するリソースにアクセスできる場合に、実行の対象となる待機スレッドの数が決定されます。

なし

セマフォオブジェクトは、指定された初期カウントと制限で初期化されます。

セマフォオブジェクトの記憶域は、ドライバーによって作成されたデバイスオブジェクトのデバイス拡張機能、ドライバーによって作成されたコントローラーオブジェクトのコントローラー拡張機能、または呼び出し元によって割り当てられた非ページプール内に存在する必要があります。

セマフォオブジェクトの詳細については、「 Semaphore オブジェクト」を参照してください。

要件	値
サポートされている最小のクライアント	Windows 2000 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport), IrqlKeDispatchLte(wdm), PowerIrpDDis(wdm)