UcmConnectorTypeCAttach, fonction (ucmmanager.h)

Article
02/07/2025

Avertit l’extension de framework du gestionnaire de connecteur USB (UcmCx) lorsqu’un connecteur partenaire est attaché.

Syntaxe

NTSTATUS UcmConnectorTypeCAttach(
  [in] UCMCONNECTOR                       Connector,
  [in] PUCM_CONNECTOR_TYPEC_ATTACH_PARAMS Params
);

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] Params

Pointeur vers un UCM_CONNECTOR_TYPEC_ATTACH_PARAMS alloué au pilote qui a été initialisé en appelant UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT.

Valeur de retour

UcmConnectorTypeCAttach retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette méthode peut retourner une valeur NTSTATUS appropriée.

Remarques

Lorsqu’une connexion à un connecteur partenaire est détectée, le pilote client appelle cette méthode pour notifier UcmCx avec des informations sur le connecteur partenaire. Ces informations incluent le rôle de connecteur, le flux vers le bas ou le port en amont, la quantité de connecteur actuel peut dessiner ou livrer et l’état de chargement. UcmCx utilise ces informations pour effectuer certaines opérations. Par exemple, il peut déterminer le rôle du connecteur partenaire attaché et configurer le contrôleur USB en mode hôte ou périphérique.

En règle générale, chaque appel UcmConnectorTypeCAttach a un appel UcmConnectorTypeCDetach pour notifier UcmCx lorsque le connecteur partenaire est détaché. Toutefois, lorsqu’un câble alimenté sans port en amont est attaché (indiqué par Params->PortPartnerType défini sur UcmTypeCPortStatePoweredCableNoUfp). Le pilote client peut appeler UcmConnectorTypeCAttach à nouveau lorsqu’une connexion est détectée au port en amont vers le câble alimenté.

Exemples

        UCM_CONNECTOR_TYPEC_ATTACH_PARAMS attachParams;

        UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT(
            &attachParams,
            UcmTypeCPortStateDfp);
        attachParams.CurrentAdvertisement = UcmTypeCCurrent1500mA;

        status = UcmConnectorTypeCAttach(
                    Connector,
                    &attachParams);
        if (!NT_SUCCESS(status))
        {
            TRACE_ERROR(
                "UcmConnectorTypeCAttach() failed with %!STATUS!.",
                status);
            goto Exit;
        }

        TRACE_INFO("UcmConnectorTypeCAttach() succeeded.");

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

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT

UcmConnectorCreate

Partager via