EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS Rückruffunktion (ucxcontroller.h)

UCX ruft diesen Rückruf auf, um die Merkmale des Hostcontrollers abzurufen.

Syntax

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS EvtUcxControllerGetTransportCharacteristics;

NTSTATUS EvtUcxControllerGetTransportCharacteristics(
  [in]  UCXCONTROLLER UcxController,
  [out] PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS UcxControllerTransportCharacteristics
)
{...}

Parameter

[in] UcxController

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

[out] UcxControllerTransportCharacteristics

Ein Zeiger auf eine UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS Struktur, die der Clienttreiber für den Hostcontroller mit Transporteigenschaften ausfüllt.

Rückgabewert

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.

Bemerkungen

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

Diese Rückruffunktion ist optional. Wenn sich die Transportmerkmale ändern, ist der Clienttreiber dafür verantwortlich, UCX zu benachrichtigen, dass eines der Merkmale mithilfe einer neuen Funktion UcxControllerNotifyTransportCharacteristicsChangegeändert wurde.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1709
mindestens unterstützte Server-	Windows Server 2016
Zielplattform-	Fenster
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Header-	ucxcontroller.h (include Ucxclass.h)
IRQL-	PASSIVE_LEVEL

Siehe auch

UcxControllerCreate