EVT_UCX_USBDEVICE_GET_CHARACTERISTIC fonction de rappel (ucxusbdevice.h)

UCX appelle ce rappel pour récupérer les caractéristiques de l’appareil.

Syntaxe

EVT_UCX_USBDEVICE_GET_CHARACTERISTIC EvtUcxUsbdeviceGetCharacteristic;

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

Paramètres

[in] UcxController

Handle du contrôleur UCX que le pilote client a reçu lors d’un appel précédent à la méthode UcxControllerCreate .

[in] UcxUsbDevice

Handle vers un objet UCX qui représente le périphérique USB que le pilote client a reçu lors d’un appel précédent à la méthode UcxUsbDeviceCreate .

[in, out] UcxUsbDeviceCharacteristic

Pointeur vers une structure UCX_USBDEVICE_CHARACTERISTIC qui contient le type de caractéristique qui intéresse l’appelant. Le pilote client remplit la valeur de la caractéristique demandée. Par exemple, si le type indique UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY, le pilote remplit la structure UCX_USBDEVICE_CHARACTERISTIC_PATH_DELAY , pointée par le membre PathDelay , avec les valeurs de délai de chemin d’accès et d’envoi appropriées.

Valeur retournée

Si l’opération réussit, la fonction de rappel doit retourner STATUS_SUCCESS, ou une autre valeur status pour laquelle NT_SUCCESS(status) est égal à TRUE. Sinon, elle doit retourner une valeur de status pour laquelle NT_SUCCESS(status) est false.

Remarques

Le pilote client UCX inscrit son implémentation auprès de l’extension du contrôleur hôte USB (UCX) en appelant la méthode UcxUsbDeviceCreate .

Configuration requise