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