共用方式為

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
目標平臺 窗戶
最低 KMDF 版本 1.15
最低 UMDF 版本 2.15
標頭 ucmmanager.h （包括 Ucmcx.h）
連結庫 UcmCxstub.lib
IRQL PASSIVE_LEVEL

另請參閱

UcmConnectorCreate