Функция 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, в противном случае — значение FALSE.

[in] CurrentPowerRole

Один из UCM_POWER_ROLE типизированных флагов, указывающий на новую роль данных.

Возвращаемое значение

None

Remarks

UcmConnectorPowerDirectionChanged возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае эта встроенная функция может возвращать соответствующее значение NTSTATUS .

Если партнер соединителя подключен, UcmCx обновляет роль управления партнером в зависимости от значения CurrentPowerRole .

UcmCx может изменять роль питания соединителя и вызывать EVT_UCM_CONNECTOR_SET_POWER_ROLE. В ответ на этот вызов клиент должен выполнить операцию PR_Swap и указать на успешность или сбой операции, вызвав UcmConnectorPowerDirectionChanged.

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

Требования

Требование Значение
Минимальная версия клиента Windows 10
Минимальная версия сервера Windows Server 2016
Целевая платформа Windows
Минимальная версия KMDF 1.15
Минимальная версия UMDF 2.15
Верхняя часть ucmmanager.h (включая Ucmcx.h)
Библиотека UcmCxstub.lib
IRQL PASSIVE_LEVEL

См. также раздел