EVT_UDECX_USB_DEVICE_D0_EXIT回呼函式 (udecxusbdevice.h)

發行項
02/26/2024

USB 裝置模擬類別擴充功能 (UdeCx) 取得將虛擬 USB 裝置傳送至低電源狀態的要求時，會叫用此回呼函式。

語法

EVT_UDECX_USB_DEVICE_D0_EXIT EvtUdecxUsbDeviceD0Exit;

NTSTATUS EvtUdecxUsbDeviceD0Exit(
  [in] WDFDEVICE UdecxWdfDevice,
  [in] UDECXUSBDEVICE UdecxUsbDevice,
  [in] UDECX_USB_DEVICE_WAKE_SETTING WakeSetting
)
{...}

參數

[in] UdecxWdfDevice

架構裝置物件的句柄，代表USB裝置所連接的控制器。用戶端驅動程式在先前呼叫 UdecxWdfDeviceAddUsbDeviceEmulation 中初始化此物件。

[in] UdecxUsbDevice

UDE 裝置物件的句柄。用戶端驅動程式會在先前呼叫 UdecxUsbDeviceCreate中建立此物件。

[in] WakeSetting

指出 USB 裝置遠端喚醒功能的 UDECX_USB_DEVICE_WAKE_SETTING類型值。

傳回值

如果作業成功，回呼函式必須傳回STATUS_SUCCESS，或NT_SUCCESS (状态) 等於 TRUE 的另一個狀態值。

備註

用戶端驅動程式已在先前呼叫 UdecxUsbDeviceInitSetStateChangeCallbacks 中註冊函式，方法是為其實作提供函式指標。

在回呼實作中，USB 裝置的用戶端驅動程式預期會執行將裝置傳送至低電源狀態的步驟。在此函式中，驅動程式可以從低鏈接電源狀態、函式暫停或兩者起始喚醒。若要這樣做，USB 2.0 裝置的驅動程序必須呼叫 UdecxUsbDeviceSignalWake 方法。 USB 3.0 裝置必須使用 UdecxUsbDeviceSignalFunctionWake。

藉由傳回STATUS_PENDING，然後稍後使用實際的完成程式代碼呼叫 UdecxUsbDeviceLinkPowerExitComplete ，即可異步完成電源要求。

規格需求

需求	值
最低支援的用戶端	Windows 10
最低支援的伺服器	Windows Server 2016
目標平台	Windows
最低 KMDF 版本	1.15
標頭	udecxusbdevice.h (包含 Udecx.h)
IRQL	<=DISPATCH_LEVEL