UcmConnectorTypeCAttach-Funktion (ucmmanager.h)
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