Funzione UcmConnectorPdPartnerSourceCaps (ucmmanager.h)

Articolo
02/29/2024

Notifica all'estensione del framework di gestione connettori USB (UcmCx) con le funzionalità di alimentazione del connettore partner.

Sintassi

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

Parametri

[in] Connector

Gestire l'oggetto connettore ricevuto dal driver client nella chiamata precedente a UcmConnectorCreate.

Pdos

Matrice allocata dal chiamante di strutture UCM_PD_POWER_DATA_OBJECT che descrive le funzionalità di alimentazione.

[in] PdoCount

Numero di elementi nella matrice specificata da Pdos[].

Valore restituito

UcmConnectorPdPartnerSourceCaps restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questo metodo può restituire un valore NTSTATUS appropriato.

Commenti

Quando si usa un connettore Type-C per la ricarica tramite il meccanismo di alimentazione (PD), il connettore locale esegue una query sul connettore partner per le funzionalità di alimentazione supportate. Tale query non è necessaria se il connettore partner è l'alimentazione perché in tal caso, il connettore locale memorizzava nella cache l'annuncio iniziale quando il connettore partner è stato collegato. Se le funzionalità di origine sono state modificate, invia un aggiornamento al connettore locale.

Se il connettore partner è il sink di alimentazione, la porta del connettore locale deve eseguire una query per le funzionalità più recenti.

Esempio

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10
Server minimo supportato	Windows Server 2016
Piattaforma di destinazione	Windows
Versione KMDF minima	1.15
Versione UMDF minima	2.15
Intestazione	ucmmanager.h (include Ucmcx.h)
Libreria	UcmCxstub.lib
IRQL	PASSIVE_LEVEL

Vedi anche

UcmConnectorCreate

Condividi tramite