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

Статья
02/07/2025

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

Синтаксис

EVT_UCX_USBDEVICE_DISABLE EvtUcxUsbdeviceDisable;

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

Параметры

[in] UcxController

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

[in] Request

Структура типа USBDEVICE_DISABLE.

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

Никакой

Замечания

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

Когда драйвер клиента выпустил ресурсы контроллера, он завершает WDFREQUEST. После завершения единственная функция обратного вызова, которая вызывает UCX, ссылающаяся на это USB-устройство, EVT_UCX_USBDEVICE_ENABLE.

Пока устройство отключено, UCX не планирует передачу данных.

Чтобы перевести устройство в требуемое состояние, драйвер контроллера узла взаимодействует с оборудованием, чтобы завершить запрос.

Драйвер клиента возвращает состояние завершения запроса. Драйвер может выполнять WDFREQUEST асинхронно.

Примеры

VOID
UsbDevice_EvtUcxUsbDeviceDisable(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)


{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceDisable");

    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);
    usbDeviceDisable = (PUSBDEVICE_DISABLE)wdfRequestParams.Parameters.Others.Arg1;
    ...

    WdfRequestComplete(Request, STATUS_SUCCESS);
}

Требования

Требование	Ценность
целевая платформа	Виндоус
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	ucxusbdevice.h (include Ucxclass.h)
IRQL	DISPATCH_LEVEL

См. также

UcxUsbDeviceCreate

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