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 方法， (UCX) 向 USB 主机控制器扩展注册此回调函数。

在回调中，驱动程序对终结点进行编程或取消编程，如 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