UcmConnectorDataDirectionChanged 函式（ucmmanager.h）

使用數據角色變更的新數據角色通知 USB 連接器管理員架構延伸模組（UcmCx）。

語法

void UcmConnectorDataDirectionChanged(
  [in] UCMCONNECTOR  Connector,
  [in] BOOLEAN       Success,
  [in] UCM_DATA_ROLE CurrentDataRole
);

[in] Connector

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

[in] Success

用來指出UcmCx使用 EVT_UCM_CONNECTOR_SET_DATA_ROLE起始的數據角色交換失敗。

如果為TRUE，表示作業成功。 FALSE，否則為。

[in] CurrentDataRole

表示新數據角色的 UCM_TYPEC_PARTNER 值。

沒有

如果作業成功，UcmConnectorDataDirectionChanged 會傳回STATUS_SUCCESS。否則，此內嵌函式可以傳回適當的 NTSTATUS 值。

如果鏈接連接器夥伴，UcmCx 會根據 CurrentDataRole 值來更新夥伴的數據角色。例如，如果用戶端驅動程式將數據角色變更為 UcmTypeCPortStateUfp，UcmCx 會將連接器夥伴的角色更新為 UcmTypeCPortStateDfp。

UcmCx 可以變更連接器的數據角色，並叫用 EVT_UCM_CONNECTOR_SET_DATA_ROLE。為了響應該呼叫，客戶端應該執行DR_Swap作業，並藉由呼叫 UcmConnectorDataDirectionChanged來指出作業的成功/失敗。

或者，客戶端驅動程式可能會選擇自動執行角色交換，或者合作夥伴可能會執行角色交換。在任一情況下，當角色交換完成時，驅動程式必須使用 UcmConnectorDataDirectionChanged向 UcmCx 報告新角色。