UdecxWdfDeviceTryHandleUserIoctl, fonction (udecxwdfdevice.h)

Article
02/29/2024

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 pour 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 pour un objet de demande d’infrastructure qui représente la requête IOCTL.

Valeur retournée

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

Remarques

Le pilote client UDE se présente aux logiciels en mode utilisateur en tant que pilote de contrôleur hôte. Le pilote client inscrit et expose le GUID de l’interface de périphérique GUID_DEVINTERFACE_USB_HOST_CONTROLLER. Les logiciels en mode utilisateur peuvent ouvrir un handle sur l’appareil en spécifiant ce GUID. En utilisant ce handle, le logiciel peut envoyer des requêtes IOCTL.

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

Le pilote client n’a pas besoin de traiter le IOCTL reçu. Il peut envoyer la demande à l’extension de classe en appelant UdecxWdfDeviceTryHandleUserIoctl. Si l’extension de classe reconnaît la requête comme une 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és, consultez IOCTL USB pour les applications et les services.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10
Serveur minimal pris en charge	Windows Server 2016
Plateforme cible	Windows
Version KMDF minimale	1.15
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