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é 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 |