Ajout d’un appareil
Avertissement
UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2.
Les exemples UMDF 1 archivés se trouvent dans la Windows 11, version 22H2 - Mise à jour des exemples de pilotes de mai 2022.
Pour plus d’informations, consultez Prise en main avec UMDF.
L’infrastructure ajoute un objet d’appareil pour chaque appareil chargé dans le processus hôte du pilote. Pour ajouter l’appareil, l’infrastructure appelle la méthode IDriverEntry::OnDeviceAdd du pilote et transmet les interfaces IWDFDriver et IWDFDeviceInitialize dans l’appel. L’interface IWDFDeviceInitialize fournie est valide uniquement avant que le pilote appelle IWDFDriver::CreateDevice. Le pilote peut appeler les méthodes suivantes de IWDFDeviceInitialize pour effectuer les opérations suivantes :
Le pilote appelle la méthode IWDFDeviceInitialize::RetrieveDevicePropertyStore pour récupérer l’interface IWDFNamedPropertyStore pour le magasin de propriétés d’appareil. Le pilote peut utiliser IWDFNamedPropertyStore pour récupérer et définir des propriétés pour l’appareil.
Le pilote appelle la méthode IWDFDeviceInitialize::SetLockingConstraint pour spécifier la façon dont ses fonctions de rappel sont appelées par l’infrastructure.
Le pilote appelle la méthode IWDFDeviceInitialize::SetFilter pour activer l’appareil en tant que périphérique de filtre.
Une fois que le pilote utilise IWDFDeviceInitialize pour initialiser l’appareil, celui-ci transmet un pointeur vers IWDFDeviceInitialize dans un appel à la méthode IWDFDriver::CreateDevice pour créer un objet d’appareil UMDF pour l’appareil. Une fois l’objet d’appareil framework créé, le pilote effectue des appels à la méthode IWDFDevice::CreateIoQueue pour créer des files d’attente d’E/S en lecture et en écriture. Dans ces appels IWDFDevice::CreateIoQueue , le pilote doit identifier la façon dont il reçoit les requêtes de la file d’attente d’E/S. Pour plus d’informations, consultez Configuration du mode de répartition pour une file d’attente d’E/S.