Fonction UcmConnectorPowerDirectionChanged (ucmmanager.h)

  • Article

Notifie l’extension du gestionnaire de connecteurs 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 que le pilote client a reçu lors de l’appel précédent à UcmConnectorCreate.

[in] Success

Utilisé pour indiquer l’échec d’un échange de rôle d’alimentation initié 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

L’un des indicateurs de type UCM_POWER_ROLE qui indique le nouveau rôle de données.

Valeur de retour

None

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/échec de l’opération en appelant UcmConnectorPowerDirectionChanged.

Le pilote client peut également 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, une fois l’échange de rôle terminé, le pilote doit signaler le nouveau rôle à UcmCx à l’aide d’UcmConnectorPowerDirectionChanged.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10
Serveur minimal pris en charge Windows Server 2016
Plateforme cible Windows
Version KMDF minimale 1.15
Version UMDF minimale 2.15
En-tête ucmmanager.h (inclure Ucmcx.h)
Bibliothèque UcmCxstub.lib
IRQL PASSIVE_LEVEL

Voir aussi