Função UcmConnectorPdPartnerSourceCaps (ucmmanager.h)

Artigo
02/07/2025

Notifica a extensão da estrutura do gerenciador de conectores USB (UcmCx) com os recursos de fonte de energia do conector de parceiro.

Sintaxe

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

Parâmetros

[in] Connector

Manipule para o objeto do conector que o driver cliente recebeu na chamada anterior para UcmConnectorCreate.

Pdos

Uma matriz alocada por chamador de estruturas de UCM_PD_POWER_DATA_OBJECT que descreve os recursos de fonte de energia.

[in] PdoCount

Número de elementos na matriz especificada por Pdos[].

Valor de retorno

ucmConnectorPdPartnerSourceCaps retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método poderá retornar um valor de NTSTATUS apropriado.

Observações

Ao usar um conector Type-C para carregamento usando o mecanismo de PD (entrega de energia), o conector local consulta o conector do parceiro para obter seus recursos de fornecimento de energia com suporte. Essa consulta não será necessária se o conector do parceiro for a fonte de energia porque, nesse caso, o conector local armazenou o anúncio inicial em cache quando o conector do parceiro foi anexado. Se os recursos de origem forem alterados, ele enviará uma atualização para o conector local.

Se o conector do parceiro for o coletor de energia, a porta do conector local deverá consultar os recursos mais recentes.

Exemplos

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10
servidor com suporte mínimo	Windows Server 2016
da Plataforma de Destino	Windows
versão mínima do KMDF	1.15
versão mínima do UMDF	2.15
cabeçalho	ucmmanager.h (inclua Ucmcx.h)
biblioteca	UcmCxstub.lib
IRQL	PASSIVE_LEVEL

Consulte também

UcmConnectorCreate

Compartilhar via