UcmConnectorPdPartnerSourceCaps-Funktion (ucmmanager.h)

Benachrichtigt die USB-Connector-Manager-Frameworkerweiterung (UcmCx) mit den Energiequellenfunktionen des Partnerconnectors.

Syntax

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

Parameter

[in] Connector

Handle mit dem Connectorobjekt, das der Clienttreiber im vorherigen Aufruf von UcmConnectorCreate empfangen hat.

Pdos

Ein vom Aufrufer zugewiesenes Array von UCM_PD_POWER_DATA_OBJECT Strukturen, das die Energiequellenfunktionen beschreibt.

[in] PdoCount

Anzahl der Elemente in dem von Pdos[]angegebenen Array.

Rückgabewert

UcmConnectorPdPartnerSourceCaps gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls kann diese Methode einen entsprechenden NTSTATUS-Wert zurückgeben.

Hinweise

Bei Verwendung eines Typ-C-Connectors zum Aufladen mithilfe des PD-Mechanismus (Power Delivery) fragt der lokale Connector den Partnerconnector nach den unterstützten Power Sourcing-Funktionen ab. Diese Abfrage ist nicht erforderlich, wenn der Partnerconnector die Stromquelle ist, da in diesem Fall der lokale Connector die anfängliche Ankündigung zwischengespeichert hat, als der Partnerconnector angefügt wurde. Wenn sich die Quellfunktionen geändert haben, wird ein Update an den lokalen Connector gesendet.

Wenn der Partnerconnector die Stromsenke ist, muss der lokale Connectorport die neuesten Funktionen abfragen.

Beispiele

        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;
        }

Anforderungen

Weitere Informationen

UcmConnectorCreate