EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED コールバック関数 (wdfdevice.h)
[KMDF と UMDF に適用]
ドライバーの EvtDeviceD0ExitPreInterruptsDisabled イベント コールバック関数は、ドライバーがデバイスのハードウェア割り込みを無効にする前に必要なデバイス固有の操作を実行します。
構文
EVT_WDF_DEVICE_D0_EXIT_PRE_INTERRUPTS_DISABLED EvtWdfDeviceD0ExitPreInterruptsDisabled;
NTSTATUS EvtWdfDeviceD0ExitPreInterruptsDisabled(
[in] WDFDEVICE Device,
[in] WDF_POWER_DEVICE_STATE TargetState
)
{...}
パラメーター
[in] Device
フレームワーク デバイス オブジェクトへのハンドル。
[in] TargetState
デバイスが入力しようとしているデバイスの電源状態を識別する、WDF_POWER_DEVICE_STATE型指定された列挙子。
戻り値
EvtDeviceD0ExitPreInterruptsDisabled コールバック関数でエラーが発生しない場合は、STATUS_SUCCESSまたは NT_SUCCESS(status) が TRUE と等しい別の状態値返す必要があります。 それ以外の場合は、NT_SUCCESS(状態) が FALSE 等しい状態値を返す必要があります。
このコールバック関数の戻り値の詳細については、「Reporting Device Failures」を参照してください。
備考
EvtDeviceD0ExitPreInterruptsDisabled コールバック関数を登録するには、ドライバーが WdfDeviceInitSetPnpPowerEventCallbacks 呼び出す必要があります。
EvtDeviceD0ExitPreInterruptsDisabled コールバック関数は、フレームワークがドライバーの EvtInterruptDisable コールバック関数を呼び出す前に、IRQL = PASSIVE_LEVEL で呼び出されます。 ドライバーは、割り込みを無効にする前にデバイス固有の操作を実行する必要がある場合に、この関数を提供できます。これらの操作は、EvtInterruptDisable コールバック関数の IRQL = DIRQL で実行しないでください。
フレームワークがこのコールバック関数を呼び出すタイミングの詳細については、「PnP と電源管理のシナリオ を参照してください。
割り込みの処理の詳細については、「ハードウェア割り込みの処理」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | 万国 |
| 最小 KMDF バージョン | 1.0 |
| UMDF の最小バージョン を する | 2.0 |
| ヘッダー | wdfdevice.h (Wdf.h を含む) |
| IRQL | PASSIVE_LEVEL (「解説」セクションを参照) |