EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS función de devolución de llamada (ucxcontroller.h)
UCX invoca esta devolución de llamada para recuperar las características del controlador de host.
Sintaxis
EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS EvtUcxControllerGetTransportCharacteristics;
NTSTATUS EvtUcxControllerGetTransportCharacteristics(
[in] UCXCONTROLLER UcxController,
[out] PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS UcxControllerTransportCharacteristics
)
{...}
Parámetros
[in] UcxController
Identificador del controlador UCX que el controlador cliente recibió en una llamada anterior al método ucxControllerCreate .
[out] UcxControllerTransportCharacteristics
Puntero a una estructura de UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS que el controlador cliente para el controlador host rellena con características de transporte.
Valor devuelto
Si la operación se realiza correctamente, la función de devolución de llamada debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(status) es igual a TRUE. De lo contrario, debe devolver un valor de estado para el que NT_SUCCESS(status) es igual a FALSE.
Observaciones
El controlador cliente UCX registra su implementación con la extensión del controlador de host USB (UCX) llamando al método UcxControllerCreate.
Esta función de devolución de llamada es opcional. Siempre que cambien las características de transporte, el controlador de cliente es responsable de notificar a UCX que una de las características ha cambiado mediante una nueva función UcxControllerNotifyTransportCharacteristicsChange.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 10, versión 1709 |
| servidor mínimo admitido | Windows Server 2016 |
| de la plataforma de destino de | Windows |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | ucxcontroller.h (incluya Ucxclass.h) |
| irQL | PASSIVE_LEVEL |