UcmConnectorPdPartnerSourceCaps-Funktion (ucmmanager.h)

Artikel
02/07/2025

Benachrichtigt die FRAMEWORK-Erweiterung des USB-Connector-Managers (UcmCx) mit den Stromversorgungsfunktionen des Partnerconnectors.

Syntax

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

Parameter

[in] Connector

Handle to the connector object that the client driver received in the previous call to UcmConnectorCreate.

Pdos

Ein aufrufergeteilte Array von UCM_PD_POWER_DATA_OBJECT Strukturen, die die Leistungsfähigkeiten beschreiben.

[in] PdoCount

Anzahl der Elemente im Array, das durch Pdos[]angegeben wird.

Rückgabewert

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

Bemerkungen

Bei Verwendung eines Type-C Connectors zum Aufladen mithilfe des Pd-Mechanismus (Power Delivery) fragt der lokale Connector den Partnerconnector nach seinen unterstützten Power Sourcing-Funktionen ab. Diese Abfrage ist nicht erforderlich, wenn der Partnerconnector die Energiequelle ist, da in diesem Fall der lokale Connector die ursprüngliche Ankündigung zwischengespeichert hat, wenn der Partnerconnector angefügt wurde. Wenn sich die Quellfunktionen geändert haben, sendet sie eine Aktualisierung an den lokalen Connector.

Wenn der Partnerconnector die Stromsenke ist, muss der lokale Verbinderport 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

Anforderung	Wert
mindestens unterstützte Client-	Windows 10
mindestens unterstützte Server-	Windows Server 2016
Zielplattform-	Fenster
Minimale KMDF-Version	1.15
Mindest-UMDF-Version	2.15
Header-	ucmmanager.h (include Ucmcx.h)
Library	UcmCxstub.lib
IRQL-	PASSIVE_LEVEL

Siehe auch

UcmConnectorCreate

Freigeben über