IPowerPolicyCallbackWakeFromSx::OnWakeFromSxTriggered method (wudfddi.h)

[Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.]

A driver's OnWakeFromSxTriggered event callback function informs the driver that its device, which had previously entered a low-power device state because system power was reduced, might have triggered a wake signal.

Syntax

void OnWakeFromSxTriggered(
  [in] IWDFDevice *pWdfDevice
);

Parameters

[in] pWdfDevice

A pointer to the IWDFDevice interface of the device object that represents one of the driver's devices.

Return value

None

Remarks

Your driver must provide an OnWakeFromSxTriggered callback function if the driver supports the IPowerPolicyCallbackWakeFromSx interface.

If the driver has registered this callback, the framework calls it after calling the driver's IPnpCallback::OnD0Entry callback function and before calling the driver's IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx callback function.

System hardware (BIOSes, motherboards, bus adapters) can sometimes drop a wake signal before the bus driver detects it, even though the signal wakes up the system. In such cases, the driver's OnWakeFromSxTriggered callback function will not be called even though the driver's device triggered a wake signal.

For more information about this callback function, see Supporting System Wake-Up in UMDF-based Drivers.

Requirements

   
End of support Unavailable in UMDF 2.0 and later.
Target Platform Desktop
Minimum UMDF version 1.9
Header wudfddi.h (include Wudfddi.h)

See also

IPowerPolicyCallbackWakeFromSx

IPowerPolicyCallbackWakeFromSx::OnArmWakeFromSx

IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx