共用方式為


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

另請參閱

架構:USB 裝置模擬 (UDE)

寫入 UDE 用戶端驅動程式