Функция 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 , указывающее новую роль данных.
Возвращаемое значение
None
Remarks
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 |
| Целевая платформа | Windows |
| Минимальная версия KMDF | 1.15 |
| Минимальная версия UMDF | 2.15 |
| Верхняя часть | ucmmanager.h (включая Ucmcx.h) |
| Библиотека | UcmCxstub.lib |
| IRQL | PASSIVE_LEVEL |