EVT_UCX_USBDEVICE_GET_CHARACTERISTIC fonction de rappel (ucxusbdevice.h)

Article
02/29/2024

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

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1709
Serveur minimal pris en charge	Windows Server 2016
Plateforme cible	Windows
Version KMDF minimale	1.0
Version UMDF minimale	2.0
En-tête	ucxusbdevice.h (inclure Ucxclass.h)
IRQL	<=DISPATCH_LEVEL

Share via