EVT_UDECX_USB_DEVICE_D0_EXIT回调函数 (udecxusbdevice.h)
USB 设备仿真类扩展 (UdeCx) 在收到将虚拟 USB 设备发送到低功耗状态的请求时调用此回调函数。
语法
EVT_UDECX_USB_DEVICE_D0_EXIT EvtUdecxUsbDeviceD0Exit;
NTSTATUS EvtUdecxUsbDeviceD0Exit(
[in] WDFDEVICE UdecxWdfDevice,
[in] UDECXUSBDEVICE UdecxUsbDevice,
[in] UDECX_USB_DEVICE_WAKE_SETTING WakeSetting
)
{...}
参数
[in] UdecxWdfDevice
表示 USB 设备连接到的控制器的框架设备对象的句柄。 客户端驱动程序在上一次调用 UdecxWdfDeviceAddUsbDeviceEmulation 中初始化了此对象。
[in] UdecxUsbDevice
UDE 设备对象的句柄。 客户端驱动程序在上一次调用 UdecxUsbDeviceCreate 时创建了此对象。
[in] WakeSetting
指示 USB 设备的远程唤醒功能的 UDECX_USB_DEVICE_WAKE_SETTING类型值。
返回值
如果操作成功,回调函数必须返回STATUS_SUCCESS,或NT_SUCCESS (状态) 等于 TRUE 的另一个状态值。
注解
客户端驱动程序在上一次调用 UdecxUsbDeviceInitSetStateChangeCallbacks 时注册了函数,方法是提供指向其实现的函数指针。
在回调实现中,USB 设备的客户端驱动程序应执行将设备发送到低功耗状态的步骤。 在此函数中,驱动程序可以从低链路电源状态和/或函数暂停状态启动其唤醒。 为此,USB 2.0 设备的驱动程序必须调用 UdecxUsbDeviceSignalWake 方法。 USB 3.0 设备必须使用 UdecxUsbDeviceSignalFunctionWake。
可以通过返回STATUS_PENDING异步完成电源请求,然后在以后使用实际完成代码调用 UdecxUsbDeviceLinkPowerExitComplete 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 |
最低受支持的服务器 | Windows Server 2016 |
目标平台 | Windows |
最低 KMDF 版本 | 1.15 |
标头 | udecxusbdevice.h (包括 Udecx.h) |
IRQL | <=DISPATCH_LEVEL |