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(status) 等於 TRUE 的另一個狀態值。
言論
用戶端驅動程式在先前呼叫 UdecxUsbDeviceInitSetStateChangeCallbacks 註冊函式,方法是提供函式指標給其實作。
在回呼實作中,USB 裝置的用戶端驅動程式預期會執行進入工作狀態的步驟。
此事件回呼函式適用於USB 3.0+ 裝置。 UdeCx 會叫用此函式,以通知用戶端驅動程式要求變更特定函式的電源狀態。 它也會通知驅動程式函式是否可以從新狀態喚醒。
電源要求可以透過傳回 STATUS_PENDING 以異步方式完成,稍後再呼叫 UdecxUsbDeviceSetFunctionSuspendAndWakeComplete 實際完成程序代碼。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 10 |
支援的最低伺服器 | Windows Server 2016 |
目標平臺 | 窗戶 |
最低 KMDF 版本 | 1.15 |
標頭 | udecxusbdevice.h (include Udecx.h) |
IRQL | <=DISPATCH_LEVEL |