UdecxWdfDeviceTryHandleUserIoctl, fonction (udecxwdfdevice.h)

  • Article

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