This topic has not yet been rated - Rate this topic

WdfDeviceInitSetPowerPolicyEventCallbacks method

The WdfDeviceInitSetPowerPolicyEventCallbacks method registers a driver's power policy event callback functions.

Syntax


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

Parameters

DeviceInit [in]: A caller-supplied pointer to a WDFDEVICE_INIT structure.
PowerPolicyEventCallbacks [in]: A pointer to a caller-initialized WDF_POWER_POLICY_EVENT_CALLBACKS structure.

Return value

None

Remarks

If your driver calls WdfDeviceInitSetPowerPolicyEventCallbacks, it must do so before it calls WdfDeviceCreate. For more information, see Creating a Framework Device Object.

For more information about WdfDeviceInitSetPowerPolicyEventCallbacks, see Power Policy Ownership.

Examples

The following code example initializes a WDF_POWER_POLICY_EVENT_CALLBACKS structure and then calls 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
                                          );

Requirements

Version	Available in version 1.0 and later versions of KMDF (see KMDF Version History).
Header	Wdfdevice.h (include Wdf.h)
Library	Wdf<MajorVersionNumber>000.sys (see Framework Library Versioning.)
IRQL	<= DISPATCH_LEVEL
DDI compliance rules	ChildDeviceInitAPI, DeviceInitAPI, DriverCreate, FDOPowerPolicyOwnerAPI, KmdfIrql, KmdfIrql2, NonFDONotPowerPolicyOwnerAPI, PdoDeviceInitAPI