UcmConnectorTypeCAttach-Funktion (ucmmanager.h)

  • Artikel

Benachrichtigt die USB-Connector-Manager-Frameworkerweiterung (UcmCx), wenn ein Partnerconnector angefügt ist.

Syntax

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

Parameter

[in] Connector

Handle mit dem Connectorobjekt, das der Clienttreiber im vorherigen Aufruf von UcmConnectorCreate empfangen hat.

[in] Params

Ein Zeiger auf eine vom Treiber zugewiesene UCM_CONNECTOR_TYPEC_ATTACH_PARAMS , die durch Aufrufen von UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT initialisiert wurde.

Rückgabewert

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

Hinweise

Wenn eine Verbindung mit einem Partnerconnector erkannt wird, ruft der Clienttreiber diese Methode auf, um UcmCx mit Informationen zum Partnerconnector zu benachrichtigen. Zu diesen Informationen gehören die Connectorrolle, der Downstream oder Upstream port, die Menge des aktuellen Connectors, die gezogen oder übermittelt werden kann, und den Ladezustand. UcmCx verwendet diese Informationen, um bestimmte Vorgänge auszuführen. Sie kann beispielsweise die Rolle des angeschlossenen Partnerconnectors bestimmen und den USB-Controller im Host- oder Peripheriegerätmodus konfigurieren.

In der Regel verfügt jeder UcmConnectorTypeCAttach-Aufruf über einen nachfolgenden UcmConnectorTypeCDetach-Aufruf , um UcmCx zu benachrichtigen, wenn der Partnerconnector getrennt wird. Wenn jedoch ein stromversorgungsfähiges Kabel ohne Upstream Anschluss angeschlossen ist (angegeben durch Params-PortPartnerType>, festgelegt auf UcmTypeCPortStatePoweredCableNoUfp). Der Clienttreiber kann UcmConnectorTypeCAttach erneut aufrufen, wenn eine Verbindung mit dem Upstream Port 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
Unterstützte Mindestversion (Client) Windows 10
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Windows
KMDF-Mindestversion 1.15
UMDF-Mindestversion 2.15
Kopfzeile ucmmanager.h (ucmcx.h einschließen)
Bibliothek UcmCxstub.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS

UCM_CONNECTOR_TYPEC_ATTACH_PARAMS_INIT

UcmConnectorErstellen