Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Уведомляет расширение платформы диспетчера соединителей 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 |