функция обратного вызова EVT_UCX_USBDEVICE_HUB_INFO (ucxusbdevice.h)

Статья
02/29/2024

Реализация драйвера клиента, вызываемая UCX для получения свойств концентратора.

Синтаксис

EVT_UCX_USBDEVICE_HUB_INFO EvtUcxUsbdeviceHubInfo;

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

Параметры

[in] UcxController

Дескриптор контроллера UCX, который драйвер клиента получил в предыдущем вызове метода UcxControllerCreate .

[in] Request

Содержит структуру USBDEVICE_HUB_INFO .

Возвращаемое значение

None

Remarks

Драйвер клиента UCX регистрирует эту функцию обратного вызова в расширении USB-контроллера узла (UCX), вызывая метод UcxUsbDeviceCreate .

Если 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);
}

Требования

Требование	Значение
Целевая платформа	Windows
Минимальная версия KMDF	1,0
Минимальная версия UMDF	2,0
Верхняя часть	ucxusbdevice.h (включая Ucxclass.h)
IRQL	DISPATCH_LEVEL

См. также раздел

UCX_USBDEVICE_EVENT_CALLBACKS

UCX_USBDEVICE_EVENT_CALLBACKS_INIT

USBDEVICE_HUB_INFO

UcxUsbDeviceCreate

Поделиться через