Compartilhar via

Função UcmConnectorPdPartnerSourceCaps (ucmmanager.h)

  • Artigo

Notifica a ucmCx (extensão de estrutura do gerenciador de conectores USB) com os recursos de fonte de energia do conector do 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 da fonte de energia.

[in] PdoCount

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

Retornar valor

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

Comentários

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 alimentação porque, nesse caso, o conector local armazenará em cache o anúncio inicial 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
Cliente mínimo com suporte Windows 10
Servidor mínimo com suporte Windows Server 2016
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

Confira também

UcmConnectorCreate