EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION Rückruffunktion (ucxcontroller.h)

  • Artikel

UCX ruft diese Rückruffunktion auf, um ihre Einstellung in den Transportmerkmalen anzugeben, für die der Clienttreiber Benachrichtigungen senden muss, wenn Änderungen auftreten.

Syntax

EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION EvtUcxControllerSetTransportCharacteristicsChangeNotification;

void EvtUcxControllerSetTransportCharacteristicsChangeNotification(
  [in] UCXCONTROLLER UcxController,
  [in] UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS ChangeNotificationFlags
)
{...}

Parameter

[in] UcxController

Ein Handle für den UCX-Controller, den der Clienttreiber bei einem vorherigen Aufruf der UcxControllerCreate-Methode empfangen hat.

[in] ChangeNotificationFlags

Eine bitweise Option von Flags, die die Typtransportmerkmale angeben, an denen UCX interessiert ist. Die Flags werden in UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS_CHANGE_FLAGS definiert.

Rückgabewert

Keine

Bemerkungen

Wenn der Vorgang erfolgreich ist, muss die Rückruffunktion STATUS_SUCCESS oder einen anderen status Wert zurückgeben, für den NT_SUCCESS(status) gleich TRUE ist. Andernfalls muss ein status Wert zurückgegeben werden, für den NT_SUCCESS(status) gleich FALSE ist.

Der UCX-Clienttreiber registriert seine Implementierung bei der USB-Hostcontrollererweiterung (UCX), indem er die UcxControllerCreate-Methode aufruft .

Für einen effizienten Stromverbrauch ruft UCX diese Rückruffunktion auf, um die Transportmerkmale anzugeben, an denen UCX interessiert ist.

Es ist wahrscheinlich, dass, wenn der Clienttreiber weiterhin nach Änderungen der Transportmerkmale im Controller sucht. Dies kann zu einem hohen Stromverbrauch führen und kann ineffizient sein, wenn keine USB-Gerätetreiber für diese Änderungsbenachrichtigung registriert sind. Um den Stromverbrauch zu optimieren, ruft UCX diese Rückruffunktion auf, um den Clienttreiber darüber zu informieren, ob Clients für Änderungen registriert sind. Diese Rückruffunktion übergibt die Änderungsbenachrichtigungsflags als Parameter. Wenn ein Flag festgelegt ist, gibt dies an, dass mindestens ein Gerätetreiber registriert ist. Wenn das Flag nicht festgelegt ist, bedeutet dies, dass keine Clients registriert sind und der Controller daher die Leistung optimieren kann.

Hinweis

Controllertreiber können diese Rückruffunktionen optional registrieren oder nutzen. Es ist gültig, dass ein Controllertreiber die Änderungsbenachrichtigung aufruft, auch wenn UCX angegeben hat, dass keine Clients dafür registriert sind.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1709
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Windows
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile ucxcontroller.h (ucxclass.h einschließen)
IRQL PASSIVE_LEVEL

Weitere Informationen