UcmConnectorPowerDirectionChanged, fonction (ucmmanager.h)
Avertit l’extension de framework du gestionnaire de connecteur USB (UcmCx) avec le nouveau rôle d’alimentation du connecteur partenaire.
Syntaxe
void UcmConnectorPowerDirectionChanged(
[in] UCMCONNECTOR Connector,
[in] BOOLEAN Success,
[in] UCM_POWER_ROLE CurrentPowerRole
);
Paramètres
[in] Connector
Gérez l’objet connecteur reçu par le pilote client lors de l’appel précédent pour UcmConnectorCreate.
[in] Success
Utilisé pour indiquer l’échec d’un échange de rôle d’alimentation qui a été lancé par UcmCx à l’aide de EVT_UCM_CONNECTOR_SET_POWER_ROLE.
Si la valeur est TRUE, l’opération a réussi. FALSE, sinon.
[in] CurrentPowerRole
Un des indicateurs UCM_POWER_ROLE-typés qui indique le nouveau rôle de données.
Valeur de retour
Aucun
Remarques
UcmConnectorPowerDirectionChanged retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette fonction inline peut retourner une valeur NTSTATUS appropriée.
Si le partenaire de connecteur est attaché, UcmCx met à jour le rôle d’alimentation du partenaire en fonction de la valeur CurrentPowerRole.
UcmCx peut modifier le rôle d’alimentation d’un connecteur et appelle EVT_UCM_CONNECTOR_SET_POWER_ROLE. En réponse à cet appel, le client doit effectuer l’opération de PR_Swap et indiquer la réussite/l’échec de l’opération en appelant UcmConnectorPowerDirectionChanged.
Sinon, le pilote client peut choisir d’effectuer un échange de rôle de manière autonome, ou le partenaire peut effectuer un échange de rôle. Dans les deux cas, lorsque l’échange de rôles est terminé, le pilote doit signaler le nouveau rôle à UcmCx à l’aide de UcmConnectorPowerDirectionChanged.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 10 |
| serveur minimum pris en charge | Windows Server 2016 |
| plateforme cible | Windows |
| version minimale de KMDF | 1.15 |
| version minimale de UMDF | 2.15 |
| d’en-tête | ucmmanager.h (include Ucmcx.h) |
| bibliothèque | UcmCxstub.lib |
| IRQL | PASSIVE_LEVEL |