UcmConnectorPdPartnerSourceCaps, fonction (ucmmanager.h)

Article
02/07/2025

Avertit l’extension de framework du gestionnaire de connecteur USB (UcmCx) avec les fonctionnalités de source d’alimentation du connecteur partenaire.

Syntaxe

NTSTATUS UcmConnectorPdPartnerSourceCaps(
  [in] UCMCONNECTOR                Connector,
       UCM_PD_POWER_DATA_OBJECT [] Pdos,
  [in] UCHAR                       PdoCount
);

Paramètres

[in] Connector

Gérez l’objet connecteur reçu par le pilote client lors de l’appel précédent pour UcmConnectorCreate.

Pdos

Tableau alloué par l’appelant de structures UCM__POWER_DATA_OBJECT qui décrit les fonctionnalités de la source d’alimentation.

[in] PdoCount

Nombre d’éléments dans le tableau spécifié par Pdos[].

Valeur de retour

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

Remarques

Lors de l’utilisation d’un connecteur Type-C pour la facturation à l’aide du mécanisme (Power Delivery), le connecteur local interroge le connecteur partenaire pour ses fonctionnalités d’approvisionnement en puissance prises en charge. Cette requête n’est pas requise si le connecteur partenaire est la source d’alimentation, car dans ce cas, le connecteur local a mis en cache la publication initiale lorsque le connecteur partenaire a été attaché. Si les fonctionnalités sources ont changé, elle envoie une mise à jour au connecteur local.

Si le connecteur partenaire est le récepteur d’alimentation, le port du connecteur local doit rechercher les fonctionnalités les plus récentes.

Exemples

        UCM_PD_POWER_DATA_OBJECT Pdos[1];

        UCM_PD_POWER_DATA_OBJECT_INIT_FIXED(&Pdos[0]);

        Pdos[0].FixedSupplyPdo.VoltageIn50mV = 100;         // 5V
        Pdos[0].FixedSupplyPdo.MaximumCurrentIn10mA = 150;  // 1.5 A

        status = UcmConnectorPdPartnerSourceCaps(
            Connector,
            Pdos,
            ARRAYSIZE(Pdos));
        if (!NT_SUCCESS(status))
        {
            TRACE_ERROR(
                "UcmConnectorPdPartnerSourceCaps() failed with %!STATUS!.",
                status);
            goto Exit;
        }

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

Partager via