KeReadStateSemaphore 関数 (wdm.h)

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

構文

LONG KeReadStateSemaphore(
  [in] PRKSEMAPHORE Semaphore
);

パラメーター

[in] Semaphore

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

戻り値

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

備考

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

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

必要条件

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

関連項目

KeInitializeSemaphore

KeReleaseSemaphore

KeWaitForSingleObject を する