Función UcmConnectorDataDirectionChanged (ucmmanager.h)

Notifica a la extensión del marco del administrador de conectores USB (UcmCx) con el nuevo rol de datos de un cambio en el rol de datos.

Sintaxis

VOID UcmConnectorDataDirectionChanged(
  [in] UCMCONNECTOR  Connector,
  [in] BOOLEAN       Success,
  [in] UCM_DATA_ROLE CurrentDataRole
);

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 datos iniciado por UcmCx mediante EVT_UCM_CONNECTOR_SET_DATA_ROLE.

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

[in] CurrentDataRole

Valor de UCM_TYPEC_PARTNER que indica el nuevo rol de datos.

Valor devuelto

Ninguno

Observaciones

UcmConnectorDataDirectionChanged 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 datos del asociado en función del valor de CurrentDataRole. Por ejemplo, si el controlador de cliente cambia el rol de datos a UcmTypeCPortStateUfp, UcmCx actualiza el rol del asociado del conector para UcmTypeCPortStateDfp.

UcmCx puede cambiar el rol de datos de un conector e invoca EVT_UCM_CONNECTOR_SET_DATA_ROLE. En respuesta a esa llamada, el cliente debe realizar la operación de DR_Swap e indicar el éxito o error de la operación llamando a UcmConnectorDataDirectionChanged.

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 UcmConnectorDataDirectionChanged.

Requisitos

Consulte también

• UcmConnectorCreate