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

Статья
02/07/2025

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(состояние) равно TRUE. В противном случае он должен вернуть значение состояния, для которого значение NT_SUCCESS(status) равно FALSE.

Замечания

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1709
минимальный поддерживаемый сервер	Windows Server 2016
целевая платформа	Виндоус
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
заголовка	ucxcontroller.h (include Ucxclass.h)
IRQL	PASSIVE_LEVEL

См. также

UcxControllerCreate

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