EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS fonction de rappel (ucxcontroller.h)

Article
02/26/2024

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 que le pilote client a reçu 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 retournée

Si l’opération réussit, la fonction de rappel doit retourner STATUS_SUCCESS ou une autre valeur status pour laquelle NT_SUCCESS(status) est égal à TRUE. Sinon, il doit retourner une valeur status pour laquelle NT_SUCCESS(status) est false.

Remarques

Le pilote client UCX inscrit son implémentation auprès de l’extension du contrôleur hôte USB (UCX) 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é d’informer UCX que l’une des caractéristiques a changé à l’aide d’une nouvelle fonction UcxControllerNotifyTransportCharacteristicsChange.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1709
Serveur minimal pris en charge	Windows Server 2016
Plateforme cible	Windows
Version KMDF minimale	1.0
Version UMDF minimale	2.0
En-tête	ucxcontroller.h (inclure Ucxclass.h)
IRQL	PASSIVE_LEVEL

Voir aussi

UcxControllerCreate

Partager via