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 ，以異步方式完成電源要求。

規格需求

另請參閱

架構：USB 裝置模擬 (UDE)

撰寫 UDE 用戶端驅動程式