次の方法で共有


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 を使用して PoFxSetComponentLatencyPoFxSetComponentResidencyおよび PoFxSetComponentWake を呼び出して、電源フレームワークへの待機時間、常駐、ウェイク ヒントを指定できます。

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

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

要件

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

こちらもご覧ください

EvtDeviceWdmPrePoFxUnregisterDevice

WdfDeviceWdmAssignPowerFrameworkSettings