EVT_UCX_USBDEVICE_GET_CHARACTERISTIC fonction de rappel (ucxusbdevice.h)

Article
02/07/2025

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 reçu par le pilote client 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 reçu par le pilote client 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 dans lequel l’appelant est intéressé. 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 membre PathDelay, avec les valeurs maximales et d’envoi appropriées du délai de chemin d’accès.

Valeur de retour

Si l’opération réussit, la fonction de rappel doit retourner STATUS_SUCCESS, ou une autre valeur d’état pour laquelle NT_SUCCESS(status) a la valeur TRUE. Sinon, il doit retourner une valeur d’état pour laquelle NT_SUCCESS(status) a la valeur FALSE.

Remarques

Le pilote client UCX inscrit son implémentation auprès de l’extension UCX (Host Controller Extension) USB en appelant la méthode UcxUsbDeviceCreate.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1709
serveur minimum pris en charge	Windows Server 2016
plateforme cible	Windows
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’en-tête	ucxusbdevice.h (include Ucxclass.h)
IRQL	<=DISPATCH_LEVEL

Partager via