共用方式為

EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE回呼函式 (udecxusbdevice.h)

  • 發行項

USB 裝置模擬類別延伸模組 (UdeCx) 叫用此回呼函式，藉由選取替代設定、停用目前的端點或新增動態端點來變更設定。

語法

EVT_UDECX_USB_DEVICE_ENDPOINTS_CONFIGURE EvtUdecxUsbDeviceEndpointsConfigure;

void EvtUdecxUsbDeviceEndpointsConfigure(
  [in] UDECXUSBDEVICE UdecxUsbDevice,
  [in] WDFREQUEST Request,
  [in] PUDECX_ENDPOINTS_CONFIGURE_PARAMS Params
)
{...}

參數

[in] UdecxUsbDevice

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

[in] Request

表示要求的架構要求物件的句柄。

[in] Params

描述組態選項 之UDECX_ENDPOINTS_CONFIGURE_PARAMS 結構的指標。

傳回值

無

備註

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

類別延伸模組會叫用此回呼函式，要求客戶端驅動程式將一或多個新的端點設定為硬體，並在不再使用一或多個現有端點時通知驅動程式。

建立端點之後，用戶端驅動程序必須先呼叫 UdecxUsbEndpointSetWdfIoQueue ，才能完成要求。

釋放端點之後，客戶端驅動程序不應該使用與端點相關聯的架構佇列物件。 類別延伸模組會將這些佇列視為已清除，以防止未來的要求。

類別延伸模組也可以透過這個回呼要求新的組態值或替代設定。

此呼叫是異步的。 用戶端驅動程序必須完成狀態，方法是完成類別延伸模組所傳遞的要求。

規格需求

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

另請參閱

架構：USB 裝置模擬 (UDE)

UdecxUsbEndpointSetWdfIoQueue

撰寫 UDE 用戶端驅動程式