UdecxWdfDeviceAddUsbDeviceEmulation, fonction (udecxwdfdevice.h)
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é dans l’appel précédent à WdfDeviceCreate.
[in] Config
Pointeur vers une structure UDECX_WDF_DEVICE_CONFIG initialisée par le pilote client en appelant UDECX_WDF_DEVICE_CONFIG_INIT.
Valeur de retour
La méthode retourne STATUS_SUCCESS si l’opération réussit. Dans le cas contraire, 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 la définition des membres appropriés de UDECX_WDF_DEVICE_CONFIG.
La méthode rend l’objet d’appareil framework capable d’effectuer des opérations liées à un contrôleur et à son hub racine, comme la gestion de différentes files d’attente requises pour traiter les demandes IOCTL envoyées au périphérique USB attaché.
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)