IPowerPolicyCallbackWakeFromSx::OnWakeFromSxTriggered method

[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

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 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

Target platform

Desktop

End of support

Unavailable in UMDF 2.0 and later.

Minimum UMDF version

1.9

Header

Wudfddi.h (include Wudfddi.h)

See also

IPowerPolicyCallbackWakeFromSx
IPowerPolicyCallbackWakeFromSx::OnArmWakeFromSx
IPowerPolicyCallbackWakeFromSx::OnDisarmWakeFromSx

 

 

Send comments about this topic to Microsoft

Show: