EVT_UCX_USBDEVICE_GET_CHARACTERISTIC funzione di callback (ucxusbdevice.h)

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 per il controller UCX ricevuto dal driver client in una chiamata precedente al metodo UcxControllerCreate.

[in] UcxUsbDevice

Handle per 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, a cui punta 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(status) è TRUE. In caso contrario, deve restituire un valore di stato per il quale NT_SUCCESS(status) è uguale a FALSE.

Osservazioni

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

Fabbisogno