共用方式為


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

另請參閱

架構:USB 裝置模擬 (UDE)

撰寫 UDE 用戶端驅動程式