Compartir a través de

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS función de devolución de llamada (ucxcontroller.h)

  • Artículo

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 del 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.

Comentarios

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. Cada vez que cambian las características de transporte, el controlador cliente es responsable de notificar a UCX que una de las características ha cambiado mediante una nueva función UcxControllerNotifyTransportCharacteristicsChange.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1709
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Versión mínima de KMDF 1.0
Versión mínima de UMDF 2.0
Encabezado ucxcontroller.h (incluya Ucxclass.h)
IRQL PASSIVE_LEVEL

Consulte también

UcxControllerCreate