Поделиться через

Функция UcmConnectorPdPartnerSourceCaps (ucmmanager.h)

  • Статья

Уведомляет расширение платформы диспетчера USB-соединителей (UcmCx) о возможностях источника питания соединителя партнера.

Синтаксис

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

Параметры

[in] Connector

Обработка объекта соединителя, полученного драйвером клиента в предыдущем вызове UcmConnectorCreate.

Pdos

Выделенный вызывающим объектом массив UCM_PD_POWER_DATA_OBJECT структур, описывающий возможности источника питания.

[in] PdoCount

Число элементов в массиве, заданном Pdos[].

Возвращаемое значение

UcmConnectorPdPartnerSourceCaps возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае этот метод может вернуть соответствующее значение NTSTATUS .

Комментарии

При использовании соединителя Type-C для зарядки с помощью механизма доставки питания (PD) локальный соединитель запрашивает у соединителя партнера поддерживаемые возможности источников питания. Этот запрос не требуется, если соединитель партнера является источником питания, так как в этом случае локальный соединитель кэшировал начальное объявление при подключении соединителя партнера. Если возможности источника изменились, он отправляет обновление в локальный соединитель.

Если соединитель партнера является приемником питания, порт локального соединителя должен запрашивать последние возможности.

Примеры

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

Требования

Требование Значение
Минимальная версия клиента Windows 10
Минимальная версия сервера Windows Server 2016
Целевая платформа Windows
Минимальная версия KMDF 1.15
Минимальная версия UMDF 2.15
Верхняя часть ucmmanager.h (включая Ucmcx.h)
Библиотека UcmCxstub.lib
IRQL PASSIVE_LEVEL

См. также раздел

UcmConnectorCreate