UcmConnectorPowerDirectionChanged 函式 (ucmmanager.h)

使用合作夥伴連接器的新電源角色，通知 USB 連接器管理員架構延伸模組 (UcmCx) 。

語法

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

[in] Connector

處理客戶端驅動程式在先前呼叫 UcmConnectorCreate中所收到的連接器物件。

[in] Success

用來指出使用 EVT_UCM_CONNECTOR_SET_POWER_ROLE 由UcmCx起始的電源角色交換失敗。

如果為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回報新角色。