EVT_UCX_CONTROLLER_SET_TRANSPORT_CHARACTERISTICS_CHANGE_NOTIFICATION Rückruffunktion (ucxcontroller.h)

UCX ruft diese Rückruffunktion auf, um die Präferenz der Transportmerkmale anzugeben, für die der Clienttreiber Benachrichtigungen senden muss, wenn Änderungen vorgenommen werden.

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 in einem vorherigen Aufruf der UcxControllerCreate-Methode empfangen hat.

[in] ChangeNotificationFlags

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

Rückgabewert

Nichts

Bemerkungen

Wenn der Vorgang erfolgreich ist, muss die Rückruffunktion STATUS_SUCCESS oder einen anderen Statuswert zurückgeben, für den NT_SUCCESS(Status) WAHR ist. Andernfalls muss ein Statuswert zurückgegeben werden, für den NT_SUCCESS(Status) FALSE entspricht.

Der UCX-Clienttreiber registriert seine Implementierung mit der USB-Hostcontrollererweiterung (UCX), indem die UcxControllerCreate-Methode aufgerufen wird.

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

Es ist wahrscheinlich, dass der Clienttreiber nach Änderungen der Transporteigenschaften 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 dem Clienttreiber mitzuteilen, ob Clients für Änderungen registriert sind. Diese Rückruffunktion übergibt die Änderungsbenachrichtigungskennzeichnungen als Parameter. Wenn ein Flag festgelegt ist, gibt es an, dass mindestens ein Gerätetreiber registriert ist. Wenn das Flag nicht festgelegt ist, bedeutet dies, dass keine Clients registriert sind und somit der Controller die Leistung optimieren kann.

Anforderungen

Siehe auch

• UcxControllerCreate