EVT_UCX_USBDEVICE_UPDATE回调函数 (ucxusbdevice.h)

项目
02/29/2024

UCX 调用以更新设备属性的客户端驱动程序实现。

语法

EVT_UCX_USBDEVICE_UPDATE EvtUcxUsbdeviceUpdate;

void EvtUcxUsbdeviceUpdate(
  [in] UCXCONTROLLER UcxController,
  [in] WDFREQUEST Request
)
{...}

参数

[in] UcxController

客户端驱动程序在上一次调用 UcxControllerCreate 方法时收到的 UCX 控制器的句柄。

[in] Request

包含 USBDEVICE_UPDATE 结构。

返回值

无

备注

UCX 客户端驱动程序通过调用 UcxUsbDeviceCreate 方法将此回调函数注册到 USB 主机控制器扩展 (UCX) 。

主控制器驱动程序与硬件进行通信，以根据需要更新描述符、LPM 参数、设备是否为中心以及最大退出延迟。

客户端驱动程序在 “请求”中返回完成状态。驱动程序可以异步完成 WDFREQUEST。

示例

VOID
UsbDevice_EvtUcxUsbDeviceUpdate(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)

{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceUpdate");

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
    usbDeviceUpdate = (PUSBDEVICE_UPDATE)wdfRequestParams.Parameters.Others.Arg1;
    ...

    WdfRequestComplete(Request, STATUS_SUCCESS);
}