KeInitializeEvent 関数 (wdm.h)

[アーティクル]
03/05/2024

KeInitializeEvent ルーチンは、イベントオブジェクトを同期 (単一のウェイター) または通知の種類のイベントとして初期化し、シグナル状態または非シグナル状態に設定します。

構文

void KeInitializeEvent(
  [out] PRKEVENT   Event,
  [in]  EVENT_TYPE Type,
  [in]  BOOLEAN    State
);

パラメーター

[out] Event

呼び出し元がストレージを提供するイベントオブジェクトへのポインター。

[in] Type

NotificationEvent または SynchronizationEvent のいずれかのイベントの種類を指定します。

[in] State

イベントの初期状態を指定します。 TRUE は シグナル状態を示します。

戻り値

なし

解説

イベントオブジェクトの記憶域は、ドライバーによって作成されたデバイスオブジェクトのデバイス拡張機能、ドライバーによって作成されたコントローラーオブジェクトのコントローラー拡張機能、または呼び出し元によって割り当てられた非ページプール内に存在する必要があります。スタックにイベントを割り当てる場合は、KeWaitForSingleObject、KeWaitForMutexObject、または KeWaitForMultipleObjects を呼び出すときに KernelMode 待機を指定する必要があります。 KernelMode 待機中、イベントを含むスタックはページングされません。

ドライバーは通常、 NotificationEvent を使用して I/O 操作が完了するまで待機します。通知イベントがシグナル状態に設定されると、イベントがシグナル状態に設定されるのを待機していたすべてのスレッドが実行の対象になります。イベントは、スレッドが KeResetEvent または KeClearEvent を呼び出して非シグナル状態でイベントを設定するまで、シグナル状態のままになります。

SynchronizationEvent は、自動設定イベントまたは自動クリア イベントとも呼ばれます。このようなイベントが設定されると、1 つの待機中のスレッドが実行の対象になります。カーネルは、待機が満たされるたびに、イベントをシグナル化されていない状態に自動的にリセットします。ドライバーは、同期イベントを使用して、複数のスレッドの操作の同期に使用される共有リソースを保護する場合があります。

イベントオブジェクトの詳細については、「イベントオブジェクト」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	任意のレベル
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport), IoAllocateIrpSignalEventInCompletion(wdm), IoAllocateIrpSignalEventInCompletion2(wdm), IoAllocateIrpSignalEventInCompletion3(wdm)、 IoAllocateIrpSignalEventInCompletionTimeout(wdm)、 IoBuildDeviceControlWait(wdm)、 IoBuildDeviceControlWaitTimeout(wdm)、 IoBuildDeviceIoControlSetEvent(wdm)、 IoBuildFsdIrpSignalEventInCompletion(wdm)、 IoBuildFsdIrpSignalEventInCompletion2(wdm), IoBuildFsdIrpSignalEventInCompletion3(wdm), IoBuildFsdIrpSignalEventInCompletionTimeout(wdm), IoBuildSynchronousFsdRequestWait(wdm), IoBuildSynchronousFsdRequestWaitTimeout(wdm), PendedCompletedRequest(wdm), PendedCompletedRequestEx(wdm), SignalEventInCompletion(wdm), SignalEventInCompletion2(wdm), SignalEventInCompletion3(wdm)、 StartDeviceWait(wdm)、 StartDeviceWait2(wdm)