EVT_UCX_USBDEVICE_GET_CHARACTERISTIC Rückruffunktion (ucxusbdevice.h)

Artikel
02/29/2024

UCX ruft diesen Rückruf auf, um die Geräteeigenschaften abzurufen.

Syntax

EVT_UCX_USBDEVICE_GET_CHARACTERISTIC EvtUcxUsbdeviceGetCharacteristic;

NTSTATUS EvtUcxUsbdeviceGetCharacteristic(
  [in]      UCXCONTROLLER UcxController,
  [in]      UCXUSBDEVICE UcxUsbDevice,
  [in, out] PUCX_USBDEVICE_CHARACTERISTIC UcxUsbDeviceCharacteristic
)
{...}

Parameter

[in] UcxController

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

[in] UcxUsbDevice

Ein Handle für ein UCX-Objekt, das das USB-Gerät darstellt, das der Clienttreiber bei einem vorherigen Aufruf der UcxUsbDeviceCreate-Methode empfangen hat.

[in, out] UcxUsbDeviceCharacteristic

Ein Zeiger auf eine UCX_USBDEVICE_CHARACTERISTIC Struktur, die den Typ des Merkmals enthält, an dem der Aufrufer interessiert ist. Der Clienttreiber füllt den Wert des angeforderten Merkmals aus. Wenn der Typ beispielsweise UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY angibt, füllt der Treiber die UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY-Struktur , auf die vom PathDelay-Member verwiesen wird, mit den entsprechenden Werten für maximale Verzögerung und Sendepfadverzögerung.

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) true entspricht. Andernfalls muss ein status Wert zurückgegeben werden, für den NT_SUCCESS(status) false entspricht.

Hinweise

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

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	ucxusbdevice.h (include Ucxclass.h)
IRQL	<=DISPATCH_LEVEL

Freigeben über