Функция Укмконнекторповердиректиончанжед (укмманажер. h)

Статья
02/16/2022
Чтение занимает 2 мин

Уведомляет расширение инфраструктуры диспетчера соединителей USB (Укмккс) с новой ролью питания соединителя партнера.

Синтаксис

void UcmConnectorPowerDirectionChanged(
  [in] UCMCONNECTOR   Connector,
  [in] BOOLEAN        Success,
  [in] UCM_POWER_ROLE CurrentPowerRole
);

Параметры

[in] Connector

Обработчик объекта соединителя, полученный драйвером клиента при предыдущем вызове укмконнекторкреате.

[in] Success

Используется для обозначения сбоя переключения роли питания, инициированного Укмккс с помощью EVT_UCM_CONNECTOR_SET_POWER_ROLE.

Если значение равно TRUE, операция выполнена успешно. FALSE, в противном случае.

[in] CurrentPowerRole

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

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

None

Remarks

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

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

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

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

Требования


Минимальная версия клиента	Windows 10
Минимальная версия сервера	Windows Server 2016
Целевая платформа	Windows
Минимальная версия КМДФ	1.15
Минимальная версия UMDF	2.15
Header	укмманажер. h (включение Укмккс. h)
Библиотека	Укмкксстуб. lib
УРОВЕНЬ	PASSIVE_LEVEL

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

укмконнекторкреате