UdecxWdfDeviceTryHandleUserIoctl, fonction (udecxwdfdevice.h)

Article
02/07/2025

Tente de gérer une requête IOCTL envoyée par un logiciel en mode utilisateur.

Syntaxe

BOOLEAN UdecxWdfDeviceTryHandleUserIoctl(
       WDFDEVICE  UdecxWdfDevice,
  [in] WDFREQUEST Request
);

Paramètres

UdecxWdfDevice

Handle vers un objet d’appareil framework qui représente le contrôleur. Le pilote client a initialisé cet objet dans l’appel précédent à UdecxWdfDeviceAddUsbDeviceEmulation.

[in] Request

Handle vers un objet de requête framework qui représente la requête IOCTL.

Valeur de retour

TRUE indique que l’extension de classe d’émulation de périphérique USB (UdeCx) a reconnu et terminé la demande (avec succès ou échec). Dans ce cas, le pilote client ne doit pas terminer la requête. FALSE dans le cas contraire ; le pilote doit effectuer la requête.

Remarques

Le pilote client UDE se présente à un logiciel en mode utilisateur en tant que pilote de contrôleur hôte. Le pilote client inscrit et expose le GUID de l’interface de l’appareil GUID_DEVINTERFACE_USB_HOST_CONTROLLER. Le logiciel en mode utilisateur peut ouvrir un handle sur l’appareil en spécifiant ce GUID. En utilisant ce handle, le logiciel peut envoyer des demandes IOCTL.

Remarque Notez que les codes IOCTL d’autres interfaces peuvent chevaucher l’interface du contrôleur hôte USB. Si ce type d’E/S atteint cette fonction, le IOCTL ne sera pas géré correctement.

Le pilote client n’a pas besoin de traiter le IOCTL reçu. Il peut envoyer la requête à l’extension de classe en appelant UdecxWdfDeviceTryHandleUserIoctl. Si l’extension de classe reconnaît la requête en tant que requête standard, elle la termine. Sinon, l’appel échoue et le pilote client est alors censé terminer la demande. Pour obtenir la liste des IOCTL qui doivent être gérées, consultez LES IOCTL USB pour les applications et les services.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10
serveur minimum pris en charge	Windows Server 2016
plateforme cible	Windows
version minimale de KMDF	1.15
d’en-tête	udecxwdfdevice.h (include Udecx.h)
bibliothèque	Udecxstub.lib
IRQL	PASSIVE_LEVEL

Voir aussi

architecture : émulation de périphérique USB (UDE)

écrire un pilote client UDE

Partager via