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