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

Controle el objeto de conector que el controlador de 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 NTSTATUS adecuado.

Comentarios

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 una llamada UcmConnectorTypeCDetach posterior para notificar a UcmCx cuando el conector del asociado está desasociado. Sin embargo, cuando se conecta un cable alimentado sin un puerto ascendente (indicado por Params-PortPartnerType> establecido en UcmTypeCPortStatePoweredCableNoUfp). El controlador cliente puede llamar a UcmConnectorTypeCAttach de nuevo 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	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

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT

UcmConnectorCreate