Share via

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

  • Artículo

UCX invoca esta función de devolución de llamada para especificar su preferencia en las características de transporte para las que el controlador cliente debe enviar notificaciones cuando se produzcan cambios.

Sintaxis

EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION EvtUcxControllerSetTransportCharacteristicsChangeNotification;

void EvtUcxControllerSetTransportCharacteristicsChangeNotification(
  [in] UCXCONTROLLER UcxController,
  [in] UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS ChangeNotificationFlags
)
{...}

Parámetros

[in] UcxController

Identificador del controlador UCX que el controlador cliente recibió en una llamada anterior al método UcxControllerCreate .

[in] ChangeNotificationFlags

Opción bit a bit de marcas que indican las características de transporte de tipo en las que UCX está interesado. Las marcas se definen en UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS.

Valor devuelto

None

Observaciones

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.

El controlador cliente UCX registra su implementación con la extensión del controlador de host USB (UCX) llamando al método UcxControllerCreate .

Para un consumo eficiente de energía, UCX invoca esta función de devolución de llamada para especificar las características de transporte en las que UCX está interesado.

Es probable que si el controlador cliente sigue buscando cambios en las características de transporte en el controlador. Esto puede dar lugar a un alto consumo de energía y puede ser ineficaz si no hay controladores de dispositivo USB registrados para esa notificación de cambio. Para optimizar el consumo de energía, UCX invoca esta función de devolución de llamada para que el controlador cliente sepa si hay clientes registrados para cambios. Esta función de devolución de llamada pasa las marcas de notificación de cambio como parámetro. Si se establece una marca, indica que hay al menos un controlador de dispositivo registrado. Si no se establece la marca, significa que no hay clientes registrados y, por lo tanto, el controlador puede optimizar la potencia.

Nota

Es opcional para que los controladores del controlador registren o usen estas funciones de devolución de llamada. Es válido para que un controlador de controlador invoque la notificación de cambio incluso si UCX ha indicado que no hay clientes registrados para él.

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