EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS Rückruffunktion (ucxcontroller.h)

  • Artikel

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 bei 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 Transportmerkmalen ausfüllt.

Rückgabewert

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.

Hinweise

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

Diese Rückruffunktion ist optional. Bei jeder Änderung der Transportmerkmale ist der Clienttreiber dafür verantwortlich, UCX zu benachrichtigen, dass sich eines der Merkmale mithilfe der neuen Funktion UcxControllerNotifyTransportCharacteristicsChange geändert hat.

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

UcxControllerErstellen