IPowerPolicyCallbackWakeFromS0::OnWakeFromS0Triggered 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 OnWakeFromS0Triggered event callback function informs the driver that its device, which had previously entered a low-power device state while the system power state remained at S0, might have triggered a wake signal.

Syntax

void OnWakeFromS0Triggered(
  IWDFDevice *pWdfDevice
);

Parameters

pWdfDevice

[in] 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 OnWakeFromS0Triggered callback function if the driver supports the IPowerPolicyCallbackWakeFromS0 interface.

If the driver provides this callback function, the framework calls the function after it calls the driver's IPnpCallback::OnD0Entry callback function and before it calls the driver's IPowerPolicyCallbackWakeFromS0::OnDisarmWakeFromS0 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 OnWakeFromS0Triggered 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 Idle Power-Down 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

IPowerPolicyCallbackWakeFromS0

IPowerPolicyCallbackWakeFromS0::OnArmWakeFromS0

IPowerPolicyCallbackWakeFromS0::OnDisarmWakeFromS0