KeInitializeSemaphore 関数 (wdm.h)

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

構文

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

[out] Semaphore

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

[in] Count

セマフォに割り当てる初期カウント値を指定します。この値は正である必要があります。 0 以外の値を指定すると、セマフォの初期状態がシグナル通知に設定されます。

[in] Limit

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

何一つ

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

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

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

要件	価値
サポートされる最小クライアント	Windows 2000 以降で使用できます。
ターゲットプラットフォームの	万国
ヘッダー	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則をする	HwStorPortProhibitedDDDIs(storport), IrqlKeDispatchLte(wdm), PowerIrpDDis(wdm)