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 |