UcmConnectorTypeCAttach 函数 (ucmmanager.h)

  • 项目

连接合作伙伴连接器时，通知 USB 连接器管理器框架扩展 (UcmCx) 。

语法

NTSTATUS UcmConnectorTypeCAttach(
  [in] UCMCONNECTOR                       Connector,
  [in] PUCM_CONNECTOR_TYPEC_ATTACH_PARAMS Params
);

参数

[in] Connector

客户端驱动程序在上一次调用 UcmConnectorCreate 时收到的连接器对象的句柄。

[in] Params

指向已通过调用 UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT 初始化的驱动程序分配 UCM_CONNECTOR_TYPEC_ATTACH_PARAMS的指针。

返回值

如果操作成功，UcmConnectorTypeCAttach 将返回STATUS_SUCCESS。 否则，此方法可以返回相应的 NTSTATUS 值。

注解

检测到与合作伙伴连接器的连接时，客户端驱动程序会调用此方法，以通知 UcmCx 有关合作伙伴连接器的信息。 该信息包括连接器角色、下流或面对上游端口、当前连接器可绘制或交付的数量以及充电状态。 UcmCx 使用该信息来执行某些操作。 例如，它可以确定附加的合作伙伴连接器的角色，并在主机或外围模式下配置 USB 控制器。

通常，每个 UcmConnectorTypeCAttach 调用都有后续 的 UcmConnectorTypeCDetach 调用，以便在合作伙伴连接器分离时通知 UcmCx。 但是，当连接没有上游端口的有源电缆 (Params-PortPartnerType> 指示时，将设置为 UcmTypeCPortStatePoweredCableNoUfp) 。 当检测到连接到上游端口到供电电缆时，客户端驱动程序可以再次调用 UcmConnectorTypeCAttach。

示例

        UCM_CONNECTOR_TYPEC_ATTACH_PARAMS attachParams;

        UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT(
            &attachParams,
            UcmTypeCPortStateDfp);
        attachParams.CurrentAdvertisement = UcmTypeCCurrent1500mA;

        status = UcmConnectorTypeCAttach(
                    Connector,
                    &attachParams);
        if (!NT_SUCCESS(status))
        {
            TRACE_ERROR(
                "UcmConnectorTypeCAttach() failed with %!STATUS!.",
                status);
            goto Exit;
        }

        TRACE_INFO("UcmConnectorTypeCAttach() succeeded.");

要求

要求 值
最低受支持的客户端 Windows 10
最低受支持的服务器 Windows Server 2016
目标平台 Windows
最低 KMDF 版本 1.15
最低 UMDF 版本 2.15
标头 ucmmanager.h (包括 Ucmcx.h)
Library UcmCxstub.lib
IRQL PASSIVE_LEVEL

另请参阅

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT

UcmConnectorCreate