UcmConnectorTypeCAttach-Funktion (ucmmanager.h)

Artikel
02/07/2025

Benachrichtigt die FRAMEWORK-Erweiterung des USB-Connector-Managers (UcmCx), wenn ein Partnerconnector angeschlossen ist.

Syntax

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

Parameter

[in] Connector

Handle to the connector object that the client driver received in the previous call to UcmConnectorCreate.

[in] Params

Ein Zeiger auf einen vom Treiber zugewiesenen UCM_CONNECTOR_TYPEC_ATTACH_PARAMS, der durch Aufrufen von UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INITinitialisiert wurde.

Rückgabewert

UcmConnectorTypeCAttach gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls kann diese Methode einen geeigneten NTSTATUS- Wert zurückgeben.

Bemerkungen

Wenn eine Verbindung mit einem Partnerconnector erkannt wird, ruft der Clienttreiber diese Methode auf, um UcmCx mit Informationen zum Partnerconnector zu benachrichtigen. Diese Informationen umfassen die Verbinderrolle, den Strom nach unten oder den vorgelagerten Anschluss, die Menge des aktuellen Verbinders kann zeichnen oder liefern und den Ladezustand. UcmCx verwendet diese Informationen, um bestimmte Vorgänge auszuführen. Sie kann z. B. die Rolle des angeschlossenen Partnerconnectors bestimmen und den USB-Controller im Host- oder Peripheriemodus konfigurieren.

In der Regel verfügt jeder UcmConnectorTypeCAttach Anruf über einen nachfolgenden UcmConnectorTypeCDetach-Aufruf, um UcmCx zu benachrichtigen, wenn der Partnerconnector getrennt wird. Wenn jedoch ein Stromkabel ohne vorgelagerten Anschluss angeschlossen ist (angegeben durch Params->PortPartnerType auf UcmTypeCPortStatePoweredCableNoUfpfestgelegt). Der Clienttreiber kann UcmConnectorTypeCAttach erneut aufrufen, wenn eine Verbindung mit dem vorgelagerten Anschluss zum angeschlossenen Kabel erkannt wird.

Beispiele

        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.");

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10
mindestens unterstützte Server-	Windows Server 2016
Zielplattform-	Fenster
Minimale KMDF-Version	1.15
Mindest-UMDF-Version	2.15
Header-	ucmmanager.h (include Ucmcx.h)
Library	UcmCxstub.lib
IRQL-	PASSIVE_LEVEL

Siehe auch

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT

UcmConnectorCreate

Freigeben über