Функция 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.

Кроме того, драйвер клиента может выбрать автономный переключение ролей или партнер может выполнить переключение ролей. В любом случае при завершении переключения ролей драйвер должен сообщить о новой роли в UcmCx с помощью UcmConnectorDataDirectionChanged.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 10
минимальный поддерживаемый сервер Windows Server 2016
целевая платформа Виндоус
минимальная версия KMDF 1.15
минимальная версия UMDF 2.15
заголовка ucmmanager.h (include Ucmcx.h)
библиотеки UcmCxstub.lib
IRQL PASSIVE_LEVEL

См. также