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

Замечания

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

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

Требования

См. также

UcxControllerCreate