Skip to content

Latest commit

 

History

History
85 lines (60 loc) · 3.25 KB

nc-wdfpdo-evt_wdf_device_enable_wake_at_bus.md

File metadata and controls

85 lines (60 loc) · 3.25 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NC:wdfpdo.EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS
EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS (wdfpdo.h)
A bus driver's EvtDeviceEnableWakeAtBus event callback function performs bus-level operations that enable one of the bus's devices to trigger a wake-up signal on the bus.
wdf\evtdeviceenablewakeatbus.htm
wdf
02/26/2018
EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS callback function
DFDeviceObjectFdoPdoRef_c418526b-2cf2-4193-b75c-f6af5d669433.xml, EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS, EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS callback, EvtDeviceEnableWakeAtBus, EvtDeviceEnableWakeAtBus callback function, kmdf.evtdeviceenablewakeatbus, wdf.evtdeviceenablewakeatbus, wdfpdo/EvtDeviceEnableWakeAtBus
wdfpdo.h
Wdf.h
Universal
1.0
PASSIVE_LEVEL
Windows
EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS
wdfpdo/EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS
APIRef
kbSyntax
UserDefined
Wdfpdo.h
EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS

EVT_WDF_DEVICE_ENABLE_WAKE_AT_BUS callback function

-description

[Applies to KMDF only]

A bus driver's EvtDeviceEnableWakeAtBus event callback function performs bus-level operations that enable one of the bus's devices to trigger a wake-up signal on the bus.

-parameters

-param Device [in]

A handle to a framework device object.

-param PowerState [in]

A SYSTEM_POWER_STATE-typed enumerator that identifies the system power state that the system or device will wake from.

-returns

If the EvtDeviceEnableWakeAtBus callback function encountered no errors, it must return STATUS_SUCCESS or another status value for which NT_SUCCESS(status) equals TRUE. Otherwise it must return a status value for which NT_SUCCESS(status) equals FALSE.

If NT_SUCCESS(status) equals FALSE, the framework calls the driver's EvtDeviceDisableWakeAtBus callback function.

For more information about this callback function's return values, see Reporting Device Failures.

-remarks

To register this callback function, the bus driver must call WdfPdoInitSetEventCallbacks.

For more information about this callback function, see Supporting System Wake-Up.

-see-also

WdfPdoInitSetEventCallbacks

EvtDeviceDisableWakeAtBus