EVT_UCM_CONNECTOR_SET_POWER_ROLE función de devolución de llamada (ucmmanager.h)

La implementación del controlador de cliente de la función de devolución de llamada de eventos EVT_UCM_CONNECTOR_SET_POWER_ROLE que establece el rol de potencia del conector en el rol especificado cuando se adjunta a un conector asociado.

Sintaxis

EVT_UCM_CONNECTOR_SET_POWER_ROLE EvtUcmConnectorSetPowerRole;

NTSTATUS EvtUcmConnectorSetPowerRole(
  [in] UCMCONNECTOR Connector,
  [in] UCM_POWER_ROLE PowerRole
)
{...}

Parámetros

[in] Connector

Controle al conector que el controlador de cliente recibió en una llamada anterior al método UcmConnectorCreate .

[in] PowerRole

Marca con tipo UCM_POWER_ROLE que especifica el rol que se va a establecer.

Valor devuelto

Si la operación se realiza correctamente, la función de devolución de llamada debe devolver STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(status) es igual a TRUE. De lo contrario, debe devolver un valor de estado para el que NT_SUCCESS(status) es igual a FALSE.

Comentarios

Para registrar una función de devolución de llamada EVT_UCM_CONNECTOR_SET_POWER_ROLE , el cliente debe llamar a UcmConnectorCreate.

La extensión del marco del administrador de conectores USB (UcmCx) puede solicitar UcmPowerRoleSink o UcmPowerRoleSource. Si el puerto ya está en el rol solicitado, el controlador cliente puede completar la solicitud sin cambios. De lo contrario, inicia una operación de intercambio de roles de energía (PR_Swap). El controlador llama a UcmConnectorPowerDirectionChanged para notificar a UcmCx el éxito o error de esa operación. El controlador puede llamar a ese método dentro de la función de devolución de llamada.

El rol persiste para la conexión actual.

Si hay una operación de intercambio de roles pendiente, UcmCx no solicita otro intercambio de roles. Esas operaciones se serializan en intercambios de roles de datos y energía.

Una vez completada la operación de intercambio, si el puerto del asociado envía una solicitud de PR_Swap, el controlador cliente debe rechazar la solicitud.

Ejemplos

EVT_UCM_CONNECTOR_SET_POWER_ROLE     EvtSetPowerRole;  

NTSTATUS  
EvtSetPowerRole(  
    UCMCONNECTOR Connector,  
    UCM_POWER_ROLE PowerRole  
    )  
{  
    PCONNECTOR_CONTEXT connCtx;  
  
    TRACE_INFO("EvtSetPowerRole(%!UCM_POWER_ROLE!) Entry", PowerRole);  
  
    connCtx = GetConnectorContext(Connector);  

    //PR_Swap operation.  
  
  
    TRACE_FUNC_EXIT();  
    return STATUS_SUCCESS;  
}  

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)
IRQL	PASSIVE_LEVEL

Consulte también

UcmConnectorCreate