KeReadStateEvent 関数 (wdm.h)
KeReadStateEvent ルーチンは、イベント オブジェクトの現在の状態 (シグナル状態またはシグナル通知されていない状態) を返します。
構文
LONG KeReadStateEvent(
[in] PRKEVENT Event
);
パラメーター
[in] Event
呼び出し元がストレージを提供する初期化されたイベント オブジェクトへのポインター。
戻り値
イベント オブジェクトが現在シグナル状態に設定されている場合は、0 以外の値が返されます。 それ以外の場合は、0 が返されます。
備考
このルーチンは、イベントのシグナル状態をポーリングする効率的な方法を提供します。 KeReadStateEvent 、イベントへのアクセスを同期せずにイベントの状態を読み取ります。 KeReadStateEvent によるイベント状態のアクセスは、イベント状態へのアクセスを同期する、KeSetEvent や KeWaitForSingleObject などのルーチンによるアクセスが相互に排他的であると想定しないでください。
次の条件が満たされている場合は、DIRQL でドライバーの割り込みサービス ルーチンからイベントの状態を読み取ることもできます。ドライバーのイベント オブジェクトは常駐しており (おそらくデバイス拡張機能内)、イベントにアクセスするその他の関数は ISR とアクセスを同期します。
イベント オブジェクトの詳細については、「イベント オブジェクトの 」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 以降で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | wdm.h (Ntddk.h を含む) |
| ライブラリ | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | HwStorPortProhibitedDDIs(storport), IrqlKeDispatchLte(wdm) |
関連項目
KeInitializeEvent の
KeResetEvent の
KeWaitForSingleObject を する