IPowerPolicyCallbackWakeFromS0::OnWakeFromS0Triggered method

[Applies to UMDF 1.x only]

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

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

IPowerPolicyCallbackWakeFromS0
IPowerPolicyCallbackWakeFromS0::OnArmWakeFromS0
IPowerPolicyCallbackWakeFromS0::OnDisarmWakeFromS0

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft