UdecxWdfDeviceAddUsbDeviceEmulation, fonction (udecxwdfdevice.h)

  • Article

Initialise un objet d’appareil framework pour prendre en charge les opérations liées à un contrôleur hôte et à un périphérique USB virtuel attaché au contrôleur.

Syntaxe

NTSTATUS UdecxWdfDeviceAddUsbDeviceEmulation(
       WDFDEVICE                WdfDevice,
  [in] PUDECX_WDF_DEVICE_CONFIG Config
);

Paramètres

WdfDevice

Handle de l’objet d’appareil framework que le pilote client a récupéré lors de l’appel précédent à WdfDeviceCreate.

[in] Config

Pointeur vers une structure de UDECX_WDF_DEVICE_CONFIG que le pilote client a initialisée en appelant UDECX_WDF_DEVICE_CONFIG_INIT.

Valeur retournée

La méthode retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette méthode peut retourner un code d’erreur NTSTATUS approprié.

Remarques

Le pilote client UDE pour le contrôleur hôte émulé et le périphérique USB doivent appeler cette méthode après l’appel WdfDeviceCreate .

Pendant cet appel, les implémentations de rappel d’événements fournies par le pilote client sont également inscrites. Fournissez des pointeurs de fonction à ces fonctions en appelant les membres appropriés de UDECX_WDF_DEVICE_CONFIG.

La méthode permet à l’objet d’appareil framework d’effectuer des opérations liées à un contrôleur et à son hub racine, telles que la gestion des différentes files d’attente requises pour traiter les demandes IOCTL envoyées à l’appareil USB attaché.

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 (inclure Udecx.h)
Bibliothèque Udecxstub.lib
IRQL PASSIVE_LEVEL

Voir aussi

Architecture : Émulation de périphérique USB (UDE)

Écrire un pilote client UDE