EVT_UCX_USBDEVICE_GET_CHARACTERISTIC Rückruffunktion (ucxusbdevice.h)

UCX ruft diesen Rückruf auf, um die Gerätemerkmale 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 in einem vorherigen Aufruf der UcxControllerCreate-Methode empfangen hat.

[in] UcxUsbDevice

Ein Handle zu einem UCX-Objekt, das das USB-Gerät darstellt, das der Clienttreiber in einem vorherigen Aufruf des 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_DELAYangibt, füllt der Treiber die UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY Struktur aus, auf die durch PathDelay Member verwiesen wird, mit den entsprechenden Maximalen- und Sendepfadverzögerungswerten.

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 UcxUsbDeviceCreate-Methode aufgerufen wird.

Anforderungen