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

Статья
02/07/2025

Уведомляет расширение платформы диспетчера 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
целевая платформа	Виндоус
минимальная версия KMDF	1.15
минимальная версия UMDF	2.15
заголовка	ucmmanager.h (include Ucmcx.h)
библиотеки	UcmCxstub.lib
IRQL	PASSIVE_LEVEL

См. также

UcmConnectorCreate

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