次の方法で共有

EVT_WDF_DEVICE_D0_ENTRYコールバック関数 (wdfdevice.h)

  • [アーティクル]

[KMDF と UMDF に適用]

ドライバーの EvtDeviceD0Entry イベント コールバック関数は、ドライバーのデバイスが D0 電源状態になったときに必要な操作を実行します。

構文

EVT_WDF_DEVICE_D0_ENTRY EvtWdfDeviceD0Entry;

NTSTATUS EvtWdfDeviceD0Entry(
  [in] WDFDEVICE Device,
  [in] WDF_POWER_DEVICE_STATE PreviousState
)
{...}

パラメーター

[in] Device

フレームワーク デバイス オブジェクトへのハンドル。

[in] PreviousState

以前のデバイスの電源状態を識別する WDF_POWER_DEVICE_STATE型指定された列挙子。

戻り値

EvtDeviceD0Entry コールバック関数でエラーが発生しない場合は、NT_SUCCESS(状態) が TRUE 等しいSTATUS_SUCCESSまたは別の状態値を返す必要があります。 それ以外の場合は、NT_SUCCESS(状態) が FALSE 等しい状態値を返す必要があります。

このコールバック関数の戻り値の詳細については、「Reporting Device Failures」を参照してください。

EvtDeviceD0Entry コールバック関数が FALSE と等しい状態値を返した後、フレームワークはドライバーの NT_SUCCESS EvtDeviceD0Exit コールバック関数呼び出しません。

備考

デバイスの EvtDeviceD0Entry コールバック関数を登録するには、ドライバーが WdfDeviceInitSetPnpPowerEventCallbacksを呼び出す必要があります。

ドライバーがデバイスの EvtDeviceD0Entry コールバック関数を登録している場合、フレームワークは、デバイスが動作 (D0) 状態になるたびに関数を呼び出します。 次のいずれかが発生すると、デバイスは D0 状態になります。

  • デバイスが列挙されます (デバイスが接続されているか、システムが再起動されたため)。
  • システムとそのすべてのデバイスは、低電力状態から動作状態に戻ります。
  • デバイスがアイドル状態であったため(デバイスが低電力アイドルをサポートしている場合)、低電力状態になった後、デバイスは動作状態に戻ります。
  • プラグ アンド プレイ マネージャーは、システムのデバイス間でシステムのハードウェア リソースを再配布しました。
フレームワークは、デバイスが動作中 (D0) 状態になり、ドライバーが使用できるが、デバイスの割り込みが有効になる直前に、EvtDeviceD0Entry コールバック関数を呼び出します。 PreviousState パラメーターは、デバイスが D0 状態に入る前のデバイスの電源状態を識別します。 フレームワークが最初 EvtDeviceD0Entryを呼び出すと、WdfPowerDeviceD3Final の PreviousState 値提供されます。

コールバック関数は、ファームウェアの読み込み、デバイスが低電力状態のときに無効になっているデバイス機能の有効化など、デバイスを完全に動作させるために必要な操作を実行する必要があります。

EvtDeviceD0Entry コールバック関数が、NT_SUCCESS(status) が FALSE 等しい状態値を返す場合、フレームワークは次の処理を行います。

  • デバイスが初めて起動する場合、フレームワークはデバイスの順序 順序 削除を開始します。
  • デバイスが低電力状態から動作状態に戻っている場合、フレームワークはデバイスのシーケンス 突然削除 開始します。
これらの状況では、フレームワークはドライバーの EvtDeviceD0Exit コールバック関数を呼び出しません。

フレームワークが EvtDeviceD0Entry コールバック関数を呼び出すタイミングの詳細については、「PnP と電源管理シナリオの」を参照してください。

このコールバック関数を提供するドライバーの詳細については、「Function Driversでの PnP と電源管理のサポート」を参照してください。

EvtDeviceD0Entry コールバック関数は IRQL = PASSIVE_LEVEL で呼び出されます。 このコールバック関数をページング可能な しないでください。

必要条件

要件 価値
ターゲット プラットフォーム の 万国
最小 KMDF バージョン 1.0
UMDF の最小バージョン を する 2.0
ヘッダー wdfdevice.h (Wdf.h を含む)
IRQL PASSIVE_LEVEL (「解説」セクションを参照)

関連項目

EvtDeviceD0Exit の