UcmConnectorPowerDirectionChanged-Funktion (ucmmanager.h)

  • Artikel

Benachrichtigt die USB-Connector-Manager-Frameworkerweiterung (UcmCx) mit der neuen Energierolle des Partnerconnectors.

Syntax

void UcmConnectorPowerDirectionChanged(
  [in] UCMCONNECTOR   Connector,
  [in] BOOLEAN        Success,
  [in] UCM_POWER_ROLE CurrentPowerRole
);

Parameter

[in] Connector

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

[in] Success

Wird verwendet, um den Fehler eines Power-Role-Austauschs anzuzeigen, der von UcmCx mithilfe von EVT_UCM_CONNECTOR_SET_POWER_ROLE initiiert wurde.

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

[in] CurrentPowerRole

Eines der UCM_POWER_ROLE typisierten Flags, das die neue Datenrolle angibt.

Rückgabewert

Keine

Bemerkungen

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

Wenn der Connectorpartner angefügt ist, aktualisiert UcmCx die Energierolle des Partners abhängig vom CurrentPowerRole-Wert .

UcmCx kann die Energierolle eines Connectors ändern und EVT_UCM_CONNECTOR_SET_POWER_ROLE aufrufen. Als Reaktion auf diesen Aufruf sollte der Client den PR_Swap Vorgang ausführen und den Erfolg/Fehler des Vorgangs durch Aufrufen von UcmConnectorPowerDirectionChanged 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 Rollentauschs ucmCx die neue Rolle mithilfe von UcmConnectorPowerDirectionChanged 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 (ucmcx.h einschließen)
Bibliothek UcmCxstub.lib
IRQL PASSIVE_LEVEL

Weitere Informationen