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