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)
Library UcmCxstub.lib
IRQL PASSIVE_LEVEL

另请参阅

UcmConnectorCreate