EVT_UDECX_USB_DEVICE_SET_FUNCTION_SUSPEND_AND_WAKE回呼函式 (udecxusbdevice.h)
USB 裝置模擬類別延伸模組 (UdeCx) 在取得變更虛擬 USB 3.0 裝置指定介面之函式狀態的要求時,叫用此回呼函式。
語法
EVT_UDECX_USB_DEVICE_SET_FUNCTION_SUSPEND_AND_WAKE EvtUdecxUsbDeviceSetFunctionSuspendAndWake;
NTSTATUS EvtUdecxUsbDeviceSetFunctionSuspendAndWake(
[in] WDFDEVICE UdecxWdfDevice,
[in] UDECXUSBDEVICE UdecxUsbDevice,
[in] ULONG Interface,
[in] UDECX_USB_DEVICE_FUNCTION_POWER FunctionPower
)
{...}
參數
[in] UdecxWdfDevice
架構裝置物件的句柄,代表USB裝置所連接的控制器。 用戶端驅動程式在先前呼叫 UdecxWdfDeviceAddUsbDeviceEmulation 中初始化此物件。
[in] UdecxUsbDevice
UDE 裝置物件的句柄。 用戶端驅動程式會在先前呼叫 UdecxUsbDeviceCreate中建立此物件。
[in] Interface
這個值是喚醒之介面的 bInterfaceNumber 。
[in] FunctionPower
UDECX_USB_DEVICE_FUNCTION_POWER類型值,指出介面是否可以暫停並將喚醒訊號傳送至主機控制器。
傳回值
如果作業成功,回呼函式必須傳回STATUS_SUCCESS,或NT_SUCCESS (状态) 等於 TRUE 的另一個狀態值。
備註
用戶端驅動程式已在先前呼叫 UdecxUsbDeviceInitSetStateChangeCallbacks 中註冊函式,方法是為其實作提供函式指標。
在回呼實作中,USB 裝置的用戶端驅動程式預期會執行進入工作狀態的步驟。
此事件回呼函式適用於USB 3.0+ 裝置。 UdeCx 會叫用此函式,以通知用戶端驅動程式要求,以變更特定函式的電源狀態。 它也會通知驅動程式函式是否可以從新狀態喚醒。
藉由傳回STATUS_PENDING,稍後再呼叫 UdecxUsbDeviceSetFunctionSuspendAndWakeComplete ,以異步方式完成電源要求。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 |
最低支援的伺服器 | Windows Server 2016 |
目標平台 | Windows |
最低 KMDF 版本 | 1.15 |
標頭 | udecxusbdevice.h (包含 Udecx.h) |
IRQL | <=DISPATCH_LEVEL |