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 en cas de modifications.
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 que le pilote client a reçu 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
None
Remarques
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.
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 .
Pour une consommation d’énergie efficace, UCX appelle cette fonction de rappel pour spécifier les caractéristiques de transport qui intéresseNT UCX.
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’énergie élevée et être inefficace si aucun pilote de périphérique USB n’est inscrit pour cette notification de modification. Pour optimiser la consommation d’énergie, UCX appelle cette fonction de rappel pour indiquer au pilote client si des clients sont inscrits pour des modifications. Cette fonction de rappel transmet les indicateurs de notification de modification en tant que paramètre. Si un indicateur est défini, cela indique qu’au moins un pilote de périphérique est inscrit. Si l’indicateur n’est pas défini, cela signifie qu’aucun client n’est inscrit et que le contrôleur peut donc optimiser l’alimentation.
Notes
Il est facultatif pour les pilotes de contrôleur d’inscrire ou d’utiliser ces fonctions de rappel. Il est valide pour un pilote de contrôleur d’appeler la notification de modification même si UCX a indiqué qu’aucun client n’est inscrit pour celle-ci.
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 |