функция обратного вызова 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 |