Функция UcmConnectorPowerDirectionChanged (ucmmanager.h)
Уведомляет расширение платформы диспетчера USB-соединителей (UcmCx) с новой ролью питания соединителя партнера.
Синтаксис
void UcmConnectorPowerDirectionChanged(
[in] UCMCONNECTOR Connector,
[in] BOOLEAN Success,
[in] UCM_POWER_ROLE CurrentPowerRole
);
Параметры
[in] Connector
Обработайте объект соединителя, полученный драйвером клиента в предыдущем вызове UcmConnectorCreate.
[in] Success
Используется для обозначения сбоя переключения ролей питания, инициированного UcmCx с помощью EVT_UCM_CONNECTOR_SET_POWER_ROLE.
Если значение TRUE, операция выполнена успешно. False, в противном случае.
[in] CurrentPowerRole
Один из флагов типа UCM_POWER_ROLE, указывающих новую роль данных.
Возвращаемое значение
Никакой
Замечания
UcmConnectorPowerDirectionChanged возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае эта встроенная функция может возвращать соответствующее значение NTSTATUS.
Если партнер соединителя подключен, UcmCx обновляет роль партнера в зависимости от значения CurrentPowerRole.
UcmCx может изменить роль питания соединителя и вызвать EVT_UCM_CONNECTOR_SET_POWER_ROLE. В ответ на этот вызов клиент должен выполнить операцию PR_Swap и указать успешность или сбой операции путем вызова UcmConnectorPowerDirectionChanged.
Кроме того, драйвер клиента может выбрать автономный переключение ролей или партнер может выполнить переключение ролей. В любом случае при завершении переключения ролей драйвер должен сообщить о новой роли в UcmCx с помощью UcmConnectorPowerDirectionChanged.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 10 |
| минимальный поддерживаемый сервер | Windows Server 2016 |
| целевая платформа | Виндоус |
| минимальная версия KMDF | 1.15 |
| минимальная версия UMDF | 2.15 |
| заголовка | ucmmanager.h (include Ucmcx.h) |
| библиотеки | UcmCxstub.lib |
| IRQL | PASSIVE_LEVEL |