UcmConnectorPowerDirectionChanged 函数 (ucmmanager.h)

通知 USB 连接器管理器框架扩展 (UcmCx) 合作伙伴连接器的新电源角色。

语法

void UcmConnectorPowerDirectionChanged(
  [in] UCMCONNECTOR   Connector,
  [in] BOOLEAN        Success,
  [in] UCM_POWER_ROLE CurrentPowerRole
);

[in] Connector

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

[in] Success

用于指示 UcmCx 使用 EVT_UCM_CONNECTOR_SET_POWER_ROLE 启动的电源角色交换失败。

如果为 TRUE，则操作成功。否则为 FALSE。

[in] CurrentPowerRole

指示新数据角色的UCM_POWER_ROLE类型标志之一。

无

如果操作成功，UcmConnectorPowerDirectionChanged 将返回STATUS_SUCCESS。否则，此内联函数可以返回相应的 NTSTATUS 值。

如果连接了连接器合作伙伴，UcmCx 将根据 CurrentPowerRole 值更新合作伙伴的电源角色。

UcmCx 可以更改连接器的电源角色，并调用 EVT_UCM_CONNECTOR_SET_POWER_ROLE。为了响应该调用，客户端应执行PR_Swap操作，并通过调用 UcmConnectorPowerDirectionChanged 来指示操作成功/失败。

或者，客户端驱动程序可以选择自动执行角色交换，或者合作伙伴可能会执行角色交换。在任一情况下，角色交换完成后，驱动程序必须使用 UcmConnectorPowerDirectionChanged 向 UcmCx 报告新角色。