EVT_UCX_USBDEVICE_GET_CHARACTERISTIC funzione di callback (ucxusbdevice.h)

Articolo
02/29/2024

UCX richiama questo callback per recuperare le caratteristiche del dispositivo.

Sintassi

EVT_UCX_USBDEVICE_GET_CHARACTERISTIC EvtUcxUsbdeviceGetCharacteristic;

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

Parametri

[in] UcxController

Handle al controller UCX ricevuto dal driver client in una chiamata precedente al metodo UcxControllerCreate .

[in] UcxUsbDevice

Handle a un oggetto UCX che rappresenta il dispositivo USB ricevuto dal driver client in una chiamata precedente al metodo UcxUsbDeviceCreate .

[in, out] UcxUsbDeviceCharacteristic

Puntatore a una struttura UCX_USBDEVICE_CHARACTERISTIC che contiene il tipo di caratteristica in cui il chiamante è interessato. Il driver client riempie il valore della caratteristica richiesta. Ad esempio, se il tipo indica UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY, il driver riempie la struttura UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY , puntata dal membro PathDelay , con i valori di ritardo del percorso massimo e di invio appropriati.

Valore restituito

Se l'operazione ha esito positivo, la funzione di callback deve restituire STATUS_SUCCESS o un altro valore di stato per cui NT_SUCCESS(stato) equivale a TRUE. In caso contrario, deve restituire un valore di stato per il quale NT_SUCCESS(stato) equivale a FALSE.

Commenti

Il driver client UCX registra l'implementazione con l'estensione del controller host USB (UCX) chiamando il metodo UcxUsbDeviceCreate .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1709
Server minimo supportato	Windows Server 2016
Piattaforma di destinazione	Windows
Versione KMDF minima	1,0
Versione UMDF minima	2,0
Intestazione	ucxusbdevice.h (include Ucxclass.h)
IRQL	<=DISPATCH_LEVEL

Condividi tramite