UcmConnectorDataDirectionChanged-Funktion (ucmmanager.h)

  • Artikel

Benachrichtigt die USB-Connector-Manager-Frameworkerweiterung (UcmCx) mit der neuen Datenrolle einer Änderung der Datenrolle.

Syntax

void UcmConnectorDataDirectionChanged(
  [in] UCMCONNECTOR  Connector,
  [in] BOOLEAN       Success,
  [in] UCM_DATA_ROLE CurrentDataRole
);

Parameter

[in] Connector

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

[in] Success

Wird verwendet, um einen Fehler eines Datenrollenaustauschs anzuzeigen, der von UcmCx mit EVT_UCM_CONNECTOR_SET_DATA_ROLE initiiert wurde.

Wenn true, war der Vorgang erfolgreich. FALSE, andernfalls.

[in] CurrentDataRole

Ein UCM_TYPEC_PARTNER Wert, der die neue Datenrolle angibt.

Rückgabewert

Keine

Bemerkungen

UcmConnectorDataDirectionChanged gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls kann diese Inlinefunktion einen entsprechenden NTSTATUS-Wert zurückgeben.

Wenn der Connectorpartner angefügt ist, aktualisiert UcmCx die Datenrolle des Partners abhängig vom CurrentDataRole-Wert . Wenn der Clienttreiber beispielsweise die Datenrolle in UcmTypeCPortStateUfp ändert, aktualisiert UcmCx die Rolle des Connectorpartners in UcmTypeCPortStateDfp.

UcmCx kann die Datenrolle eines Connectors ändern und EVT_UCM_CONNECTOR_SET_DATA_ROLE aufrufen. Als Reaktion auf diesen Aufruf sollte der Client den DR_Swap-Vorgang ausführen und den Erfolg/Fehler des Vorgangs durch Aufrufen von UcmConnectorDataDirectionChanged angeben.

Alternativ kann der Clienttreiber einen Rollentausch autonom durchführen, oder der Partner führt einen Rollentausch durch. In beiden Fällen muss der Treiber nach Abschluss des Rollenwechsels die neue Rolle mithilfe von UcmConnectorDataDirectionChanged an UcmCx melden.

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 (include Ucmcx.h)
Bibliothek UcmCxstub.lib
IRQL PASSIVE_LEVEL

Weitere Informationen