EVT_UCX_USBDEVICE_HUB_INFO回调函数（ucxusbdevice.h）

2025-02-07

UCX 调用以检索中心属性的客户端驱动程序实现。

语法

EVT_UCX_USBDEVICE_HUB_INFO EvtUcxUsbdeviceHubInfo;

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

参数

[in] UcxController

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

[in] Request

包含 USBDEVICE_HUB_INFO 结构。

返回值

没有

言论

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

如果 USB 设备不是中心，请不要提供此回调。

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

例子

VOID
UsbDevice_EvtUcxUsbDeviceHubInfo(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)

{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceHubInfo");

    //
    // Retrieve the USBDEVICE_HUB_INFO pointer from the
    // IOCTL_INTERNAL_USB_USBDEVICE_HUB_INFO WdfRequest.
    //
    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);

    hubInfo = (PUSBDEVICE_HUB_INFO)wdfRequestParams.Parameters.Others.Arg1;

    ....


    WdfRequestComplete(Request, STATUS_SUCCESS);
}