Función UcmConnectorPowerDirectionChanged (ucmmanager.h)
Notifica a la extensión del marco del administrador de conectores USB (UcmCx) con el nuevo rol de energía del conector asociado.
Sintaxis
void UcmConnectorPowerDirectionChanged(
[in] UCMCONNECTOR Connector,
[in] BOOLEAN Success,
[in] UCM_POWER_ROLE CurrentPowerRole
);
Parámetros
[in] Connector
Identificador del objeto de conector que el controlador 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 de tipo UCM_POWER_ROLEque indica el nuevo rol de datos.
Valor devuelto
Ninguno
Observaciones
UcmConnectorPowerDirectionChanged devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta función insertada puede devolver un valor de NTSTATUS adecuado.
Si el asociado del conector está asociado, UcmCx actualiza el rol de energía del asociado en función del valor de 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 el é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 | Valor |
|---|---|
| cliente mínimo admitido | Windows 10 |
| servidor mínimo admitido | Windows Server 2016 |
| de la plataforma de destino de | Windows |
| versión mínima de KMDF | 1.15 |
| versión mínima de UMDF | 2.15 |
| encabezado de | ucmmanager.h (include Ucmcx.h) |
| biblioteca de | UcmCxstub.lib |
| irQL | PASSIVE_LEVEL |