Compartir a través de

Función UcmConnectorPdPartnerSourceCaps (ucmmanager.h)

  • Artículo

Notifica a la extensión del marco del administrador de conectores USB (UcmCx) las funcionalidades de fuente de alimentación del conector asociado.

Sintaxis

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

Parámetros

[in] Connector

Identificador del objeto de conector que el controlador de cliente recibió en la llamada anterior a UcmConnectorCreate.

Pdos

Matriz asignada por el autor de la llamada de estructuras UCM_PD_POWER_DATA_OBJECT que describe las funcionalidades de la fuente de alimentación.

[in] PdoCount

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

Valor devuelto

UcmConnectorPdPartnerSourceCaps devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método puede devolver un valor NTSTATUS adecuado.

Comentarios

Cuando se usa un conector type-C para cargar mediante el mecanismo de entrega de energía (PD), el conector local consulta el conector asociado para conocer sus capacidades de suministro de energía compatibles. Esa consulta no es necesaria si el conector asociado es la fuente de alimentación porque, en ese caso, el conector local almacena en caché el anuncio inicial cuando se adjuntó el conector asociado. Si las funcionalidades de origen han cambiado, envía una actualización al conector local.

Si el conector asociado es el receptor de energía, el puerto del conector local debe consultar las funcionalidades más recientes.

Ejemplos

        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 Value
Cliente mínimo compatible Windows 10
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Versión mínima de KMDF 1.15
Versión mínima de UMDF 2.15
Encabezado ucmmanager.h (incluya Ucmcx.h)
Library UcmCxstub.lib
IRQL PASSIVE_LEVEL

Consulte también

UcmConnectorCreate