EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION fonction de rappel (ucxcontroller.h)
UCX appelle cette fonction de rappel pour spécifier sa préférence dans les caractéristiques de transport pour lesquelles le pilote client doit envoyer des notifications lorsque des modifications se produisent.
Syntaxe
EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION EvtUcxControllerSetTransportCharacteristicsChangeNotification;
void EvtUcxControllerSetTransportCharacteristicsChangeNotification(
[in] UCXCONTROLLER UcxController,
[in] UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS ChangeNotificationFlags
)
{...}
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.
[in] ChangeNotificationFlags
Option au niveau du bit des indicateurs qui indiquent les caractéristiques de transport de type dans lesquelles UCX est intéressé. Les indicateurs sont définis dans UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS.
Valeur de retour
Aucun
Remarques
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.
Le pilote client UCX inscrit son implémentation auprès de l’extension UCX (Host Controller Extension) USB en appelant la méthode UcxControllerCreate.
Pour une consommation d’énergie efficace, UCX appelle cette fonction de rappel pour spécifier les caractéristiques de transport dans lesquelles UCX est intéressé.
Il est probable que si le pilote client continue de rechercher des modifications dans les caractéristiques de transport dans le contrôleur. Cela peut entraîner une consommation d’alimentation élevée et peut être inefficace s’il n’existe aucun pilote de périphérique USB inscrit pour cette notification de modification. Pour optimiser la consommation d’alimentation, UCX appelle cette fonction de rappel pour informer le pilote client si des clients sont inscrits pour les modifications. Cette fonction de rappel transmet les indicateurs de notification de modification en tant que paramètre. Si un indicateur est défini, il indique qu’il existe au moins un pilote de périphérique inscrit. Si l’indicateur n’est pas défini, cela signifie qu’il n’y a aucun client inscrit et par conséquent, le contrôleur peut optimiser l’alimentation.
Note
Il est facultatif que les pilotes de contrôleur inscrivent ou utilisent ces fonctions de rappel. Il est valide pour qu’un pilote de contrôleur appelle la notification de modification même si UCX n’a indiqué qu’il n’y a aucun client inscrit pour celui-ci.
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 |