Función UcmConnectorTypeCAttach (ucmmanager.h)

Notifica a la extensión del marco del administrador de conectores USB (UcmCx) cuando se conecta un conector asociado.

Sintaxis

NTSTATUS UcmConnectorTypeCAttach(
  [in] UCMCONNECTOR                       Connector,
  [in] PUCM_CONNECTOR_TYPEC_ATTACH_PARAMS Params
);

Parámetros

[in] Connector

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

[in] Params

Puntero a un UCM_CONNECTOR_TYPEC_ATTACH_PARAMS asignado por el controlador que se ha inicializado llamando a UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT.

Valor devuelto

UcmConnectorTypeCAttach devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, este método puede devolver un valor de NTSTATUS adecuado.

Observaciones

Cuando se detecta una conexión a un conector de asociado, el controlador cliente llama a este método para notificar a UcmCx información sobre el conector de asociado. Esa información incluye el rol del conector, el flujo descendente o el puerto orientado hacia arriba, la cantidad de conector actual puede dibujar o entregar y el estado de carga. UcmCx usa esa información para realizar determinadas operaciones. Por ejemplo, puede determinar el rol del conector asociado conectado y configurar el controlador USB en modo host o periférico.

Normalmente, cada llamada UcmConnectorTypeCAttach tiene un UcmConnectorTypeCDetach posterior llamada para notificar a UcmCx cuando se desasocia el conector del asociado. Sin embargo, cuando un cable alimentado sin un puerto ascendente está conectado (indicado por Params->PortPartnerType establecido en UcmTypeCPortStatePoweredCableNoUfp). El controlador cliente puede llamar a UcmConnectorTypeCAttach cuando se detecta una conexión al puerto ascendente al cable alimentado.

Ejemplos

        UCM_CONNECTOR_TYPEC_ATTACH_PARAMS attachParams;

        UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT(
            &attachParams,
            UcmTypeCPortStateDfp);
        attachParams.CurrentAdvertisement = UcmTypeCCurrent1500mA;

        status = UcmConnectorTypeCAttach(
                    Connector,
                    &attachParams);
        if (!NT_SUCCESS(status))
        {
            TRACE_ERROR(
                "UcmConnectorTypeCAttach() failed with %!STATUS!.",
                status);
            goto Exit;
        }

        TRACE_INFO("UcmConnectorTypeCAttach() succeeded.");

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

Consulte también

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT

UcmConnectorCreate