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 報告新角色。