KeReadStateSemaphore 関数 (wdm.h)

  • [アーティクル]

KeReadStateSemaphore ルーチンは、指定されたセマフォ オブジェクトの現在の状態 (シグナルまたはシグナルなし) を返します。

構文

LONG KeReadStateSemaphore(
  [in] PRKSEMAPHORE Semaphore
);

パラメーター

[in] Semaphore

呼び出し元がストレージを提供する初期化されたセマフォ オブジェクトへのポインター。

戻り値

戻り値が 0 の場合、セマフォ オブジェクトはシグナルなしの状態に設定されます。

注釈

このルーチンは、セマフォのシグナル状態を効率的にポーリングする方法を提供します。 KeReadStateSemaphore は、セマフォへのアクセスを同期せずにセマフォの状態を読み取ります。 KeReadStateSemaphore によるセマフォ状態のアクセスは、セマフォ状態へのアクセスを同期する、KeReleaseSemaphore や KeWaitForSingleObject などのルーチンによるアクセスを相互に排他的であると想定しないでください。

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

要件

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

こちらもご覧ください

KeInitializeSemaphore

KeReleaseSemaphore

KeWaitForSingleObject