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

  • Статья

UCX вызывает этот обратный вызов для получения характеристик контроллера узла.

Синтаксис

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS EvtUcxControllerGetTransportCharacteristics;

NTSTATUS EvtUcxControllerGetTransportCharacteristics(
  [in]  UCXCONTROLLER UcxController,
  [out] PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS UcxControllerTransportCharacteristics
)
{...}

Параметры

[in] UcxController

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

[out] UcxControllerTransportCharacteristics

Указатель на структуру UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS , которую драйвер клиента для контроллера узла заполняет характеристиками транспорта.

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

Если операция выполнена успешно, функция обратного вызова должна возвращать STATUS_SUCCESS или другое значение состояния, для которого NT_SUCCESS(status) равно TRUE. В противном случае он должен возвращать значение состояния, для которого NT_SUCCESS (status) равно FALSE.

Комментарии

Драйвер клиента UCX регистрирует свою реализацию в расширении КОНТРОЛЛЕРа узла USB (UCX), вызывая метод UcxControllerCreate .

Эта функция обратного вызова является необязательной. При изменении характеристик транспорта драйвер клиента отвечает за уведомление UCX о том, что одна из характеристик изменилась с помощью новой функции UcxControllerNotifyTransportCharacteristicsChange.

Требования

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

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

UcxControllerCreate