WdfDeviceInitSetPowerPolicyEventCallbacks 関数 (wdfdevice.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WdfDeviceInitSetPowerPolicyEventCallbacks メソッドは、ドライバーの電源ポリシー イベント コールバック関数を登録します。

構文

void WdfDeviceInitSetPowerPolicyEventCallbacks(
  [in] PWDFDEVICE_INIT                   DeviceInit,
  [in] PWDF_POWER_POLICY_EVENT_CALLBACKS PowerPolicyEventCallbacks
);

パラメーター

[in] DeviceInit

WDFDEVICE_INIT構造体への呼び出し元が指定したポインター。

[in] PowerPolicyEventCallbacks

呼び出し元によって初期化 されたWDF_POWER_POLICY_EVENT_CALLBACKS 構造体へのポインター。

戻り値

なし

解説

ドライバーが WdfDeviceInitSetPowerPolicyEventCallbacks を呼び出す場合は、 WdfDeviceCreate を呼び出す前に呼び出す必要があります。 詳細については、「 Framework デバイス オブジェクトの作成」を参照してください。

WdfDeviceInitSetPowerPolicyEventCallbacks の詳細については、「Power Policy 所有権」を参照してください。

例

次のコード例では、 WDF_POWER_POLICY_EVENT_CALLBACKS 構造体を初期化し、 WdfDeviceInitSetPowerPolicyEventCallbacks を呼び出します。

WDF_POWER_POLICY_EVENT_CALLBACKS powerPolicyCallbacks;

WDF_POWER_POLICY_EVENT_CALLBACKS_INIT(&powerPolicyCallbacks);
powerPolicyCallbacks.EvtDeviceArmWakeFromS0 = PciDrvEvtDeviceWakeArmS0;
powerPolicyCallbacks.EvtDeviceDisarmWakeFromS0 = PciDrvEvtDeviceWakeDisarmS0;
powerPolicyCallbacks.EvtDeviceWakeFromS0Triggered = PciDrvEvtDeviceWakeTriggeredS0;
powerPolicyCallbacks.EvtDeviceArmWakeFromSx = PciDrvEvtDeviceWakeArmSx;
powerPolicyCallbacks.EvtDeviceDisarmWakeFromSx = PciDrvEvtDeviceWakeDisarmSx;
powerPolicyCallbacks.EvtDeviceWakeFromSxTriggered = PciDrvEvtDeviceWakeTriggeredSx;
WdfDeviceInitSetPowerPolicyEventCallbacks(
                                          DeviceInit,
                                          &powerPolicyCallbacks
                                          );

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header wdfdevice.h (Wdf.h を含む)
Library Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 ChildDeviceInitAPI(kmdf)、DeviceInitAPI(kmdf)、DriverCreate(kmdf)、FDOPowerPolicyOwnerAPI(kmdf)、KmdfIrql(kmdf)、KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)、NonFDONotPowerPolicyOwnerAPI(kmdf)、PdoDeviceInitAPI(kmdf)

こちらもご覧ください

WDF_POWER_POLICY_EVENT_CALLBACKS_INIT

WdfDeviceInitSetPnpPowerEventCallbacks