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

  • [アーティクル]

[KMDF にのみ適用]

EvtDeviceWdmPostPoFxRegisterDevice コールバック関数は、フレームワークが電源フレームワークに登録された後、デバイス固有の操作を実行します。

構文

EVT_WDFDEVICE_WDM_POST_PO_FX_REGISTER_DEVICE EvtWdfdeviceWdmPostPoFxRegisterDevice;

NTSTATUS EvtWdfdeviceWdmPostPoFxRegisterDevice(
  [in] WDFDEVICE Device,
  [in] POHANDLE PoHandle
)
{...}

パラメーター

[in] Device

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

[in] PoHandle

デバイスの電源フレームワークへの登録を表すハンドル。

戻り値

このコールバックで実行された操作の成功または失敗を示す NTSTATUS 値。 エラーが返された場合、フレームワークは IRP_MN_START_DEVICE失敗します。

注釈

複数の機能の電源状態を定義する単一コンポーネント デバイス用の KMDF ドライバーを作成する場合は、フレームワークが電源管理フレームワーク (PoFx) に登録した後に通知を受け取る EvtDeviceWdmPostPoFxRegisterDevice コールバック関数を登録できます。

EvtDeviceWdmPostPoFxRegisterDevice を登録するには、ドライバーで WdfDeviceWdmAssignPowerFrameworkSettings を呼び出す必要があります。

EvtDeviceWdmPostPoFxRegisterDevice で受け取った POHANDLE は、ドライバーが EvtDeviceWdmPrePoFxUnregisterDevice から戻るまで有効なままです。

ドライバーは POHANDLE を使用して PoFxSetComponentLatency、 PoFxSetComponentResidency、 および PoFxSetComponentWake を呼び出して、電源フレームワークへの待機時間、常駐、ウェイク ヒントを指定できます。

ドライバーは POHANDLE を使用して PoFxPowerControl を呼び出し、電源制御要求を PoFx に送信することもできます。

複数のコンポーネント デバイスの KMDF ドライバーでは、 EvtDeviceWdmPostPoFxRegisterDevice は提供されません。 代わりに、このようなドライバーは PoFxRegisterDevice を呼び出すときに POHANDLE を受け取ります。 詳細については、「 Multiple-Component デバイスの複数機能電源状態のサポート」を参照してください。

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.11
Header wdfdevice.h (Wdf.h を含む)
IRQL PASSIVE_LEVEL

こちらもご覧ください

EvtDeviceWdmPrePoFxUnregisterDevice

WdfDeviceWdmAssignPowerFrameworkSettings