Función UcmConnectorPdPartnerSourceCaps (ucmmanager.h)

Notifica a la extensión del marco del administrador de conectores USB (UcmCx) con 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 cliente recibió en la llamada anterior a UcmConnectorCreate.

Pdos

Matriz asignada por el autor de la llamada de estructuras de 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 de NTSTATUS adecuado.

Observaciones

Cuando se usa un conector de Type-C para la carga mediante el mecanismo de entrega de energía (PD), el conector local consulta el conector asociado para sus funcionalidades de suministro de energía compatibles. Esa consulta no es necesaria si el conector asociado es el origen de energía 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	Valor
cliente mínimo admitido	Windows 10
servidor mínimo admitido	Windows Server 2016
de la plataforma de destino de	Windows
versión mínima de KMDF	1.15
versión mínima de UMDF	2.15
encabezado de	ucmmanager.h (include Ucmcx.h)
biblioteca de	UcmCxstub.lib
irQL	PASSIVE_LEVEL

Consulte también

UcmConnectorCreate