EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS fonction de rappel (ucxcontroller.h)

Article
02/07/2025

UCX appelle ce rappel pour récupérer les caractéristiques du contrôleur hôte.

Syntaxe

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS EvtUcxControllerGetTransportCharacteristics;

NTSTATUS EvtUcxControllerGetTransportCharacteristics(
  [in]  UCXCONTROLLER UcxController,
  [out] PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS UcxControllerTransportCharacteristics
)
{...}

Paramètres

[in] UcxController

Handle du contrôleur UCX reçu par le pilote client lors d’un appel précédent à la méthode UcxControllerCreate.

[out] UcxControllerTransportCharacteristics

Pointeur vers une structure UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS que le pilote client du contrôleur hôte remplit avec les caractéristiques de transport.

Valeur de retour

Si l’opération réussit, la fonction de rappel doit retourner STATUS_SUCCESS, ou une autre valeur d’état pour laquelle NT_SUCCESS(status) a la valeur TRUE. Sinon, il doit retourner une valeur d’état pour laquelle NT_SUCCESS(status) a la valeur FALSE.

Remarques

Le pilote client UCX inscrit son implémentation auprès de l’extension UCX (Host Controller Extension) USB en appelant la méthode UcxControllerCreate.

Cette fonction de rappel est facultative. Chaque fois que les caractéristiques de transport changent, le pilote client est chargé de notifier UCX que l’une des caractéristiques a changé à l’aide d’une nouvelle fonction UcxControllerNotifyTransportCharacteristicsChange.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1709
serveur minimum pris en charge	Windows Server 2016
plateforme cible	Windows
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’en-tête	ucxcontroller.h (include Ucxclass.h)
IRQL	PASSIVE_LEVEL

Voir aussi

ucxControllerCreate

Partager via