UcmConnectorPdPartnerSourceCaps, fonction (ucmmanager.h)

Article
03/01/2024

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

Pdos

Tableau de structures UCM_PD_POWER_DATA_OBJECT alloués par l’appelant 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 retournée

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 recharge à l’aide du mécanisme de distribution d’alimentation, le connecteur local interroge le connecteur partenaire pour connaître ses fonctionnalités d’approvisionnement en énergie prises en charge. Cette requête n’est pas obligatoire 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 de la source ont changé, il 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;
        }

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

UcmConnectorCreate

Partager via