Compartir a través de

Función UcmConnectorPowerDirectionChanged (ucmmanager.h)

  • Artículo

Notifica a la extensión del marco del administrador de conectores USB (UcmCx) con el nuevo rol de potencia del conector asociado.

Sintaxis

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

Parámetros

[in] Connector

Controle el objeto de conector que el controlador de cliente recibió en la llamada anterior a UcmConnectorCreate.

[in] Success

Se usa para indicar el error de un intercambio de roles de energía iniciado por UcmCx mediante EVT_UCM_CONNECTOR_SET_POWER_ROLE.

Si es TRUE, la operación se realizó correctamente. FALSE, de lo contrario.

[in] CurrentPowerRole

Una de las marcas con tipo UCM_POWER_ROLE que indica el nuevo rol de datos.

Valor devuelto

None

Observaciones

UcmConnectorPowerDirectionChanged devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta función insertada puede devolver un valor NTSTATUS adecuado.

Si el asociado del conector está asociado, UcmCx actualiza el rol de potencia del asociado en función del valor CurrentPowerRole .

UcmCx puede cambiar el rol de potencia de un conector e invoca EVT_UCM_CONNECTOR_SET_POWER_ROLE. En respuesta a esa llamada, el cliente debe realizar la operación de PR_Swap e indicar éxito o error de la operación llamando a UcmConnectorPowerDirectionChanged.

Como alternativa, el controlador de cliente podría optar por realizar un intercambio de roles de forma autónoma o el asociado podría realizar un intercambio de roles. En cualquier caso, cuando se haya completado el intercambio de roles, el controlador debe notificar el nuevo rol a UcmCx mediante UcmConnectorPowerDirectionChanged.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10
Servidor mínimo compatible Windows Server 2016
Plataforma de destino Windows
Versión mínima de KMDF 1.15
Versión mínima de UMDF 2.15
Encabezado ucmmanager.h (incluya Ucmcx.h)
Library UcmCxstub.lib
IRQL PASSIVE_LEVEL

Consulte también