Share via

Función UcmConnectorDataDirectionChanged (ucmmanager.h)

  • Artículo

Notifica a la extensión del marco del administrador de conectores USB (UcmCx) 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 de 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 UCM_TYPEC_PARTNER que indica el nuevo rol de datos.

Valor devuelto

None

Observaciones

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

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