EVT_UCX_USBDEVICE_ENDPOINTS_CONFIGURE回呼函式 (ucxusbdevice.h)

  • 發行項

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);
}

規格需求

需求 值
目標平台 Windows
最低 KMDF 版本 1.0
最低UMDF版本 2.0
標頭 ucxusbdevice.h (包含 Ucxclass.h)
IRQL DISPATCH_LEVEL

另請參閱

ENDPOINTS_CONFIGURE

UcxUsbDeviceCreate