UCX 呼叫以在控制器中設定端點的用戶端驅動程序實作。
語法
EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE EvtUcxUsbdeviceEndpointsConfigure;
VOID EvtUcxUsbdeviceEndpointsConfigure(
[in] UCXCONTROLLER UcxController,
[in] WDFREQUEST Request
)
{...}
參數
[in] UcxController
用戶端驅動程式在先前呼叫 UcxControllerCreate 方法時收到的 UCX 控制器句柄。
[in] Request
包含類型為 ENDPOINTS_CONFIGURE 結構的結構。
傳回值
沒有
言論
UCX 用戶端驅動程式會呼叫 UcxUsbDeviceCreate 方法,向 USB 主機控制器擴充功能 (UCX) 註冊此回呼函式。
在回呼中,驅動程式會程式或取消程式代碼端點,如 ENDPOINTS_CONFIGURE 結構中所述。
此回呼不會啟用或停用預設端點。 默認端點的狀態會系結至裝置的狀態。 驅動程式會在 EVT_UCX_USBDEVICE_DISABLE 和 EVT_UCX_USBDEVICE_ENABLE 回呼函式中實作啟用和停用作業。
用戶端驅動程式會在 要求中傳回完成狀態。 驅動程式可以異步完成 WDFREQUEST。
例子
VOID
UsbDevice_EvtUcxUsbDeviceEndpointsConfigure(
UCXCONTROLLER UcxController,
WDFREQUEST Request
)
{
UNREFERENCED_PARAMETER(UcxController);
DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceEndpointsConfigure");
WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
...
endpointsConfigure = (PENDPOINTS_CONFIGURE)wdfRequestParams.Parameters.Others.Arg1;
...
WdfRequestComplete(Request, STATUS_SUCCESS);
}
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 窗戶 |
| 最低 KMDF 版本 | 1.0 |
| 最低 UMDF 版本 | 2.0 |
| 標頭 | ucxusbdevice.h (include Ucxclass.h) |
| IRQL | DISPATCH_LEVEL |