Partager via


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

Voir aussi

  • UcmConnectorCreate