Objet d’appareil framework

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’objet de périphérique framework est exposé aux pilotes par l’interface IWDFDevice . L’objet d’appareil framework est la représentation de l’infrastructure de l’appareil sur le système. Chaque objet d’appareil a un objet pilote parent.

Lorsqu’un nouvel appareil arrive dans le système, l’infrastructure appelle la méthode IDriverEntry::OnDeviceAdd pour informer le pilote de l’arrivée et passe les interfaces IWDFDriver et IWDFDeviceInitialize dans l’appel. Le pilote peut appeler des méthodes de l’interface IWDFDeviceInitialize pour initialiser le nouvel appareil. Par exemple, le pilote appelle la méthode IWDFDeviceInitialize::RetrieveDevicePropertyStore pour rechercher les informations sur l’appareil fournies dans le cadre de l’installation de l’appareil. Le pilote peut ensuite appeler la méthode IWDFDriver::CreateDevice pour configurer et créer l’objet d’appareil.

Lorsque les pilotes créent un objet d’appareil framework, ils peuvent inscrire leurs interfaces IPnpCallback, IPnpCallbackSelfManagedIo, IPnpCallbackHardware, IFileCallbackCleanup et IFileCallbackClose . L’infrastructure avertit ensuite le pilote lorsque des événements de nettoyage et de fermeture de fichiers et de Plug-and-Play (PnP) et de gestion de l’alimentation (PM) se produisent. Pour plus d’informations sur la prise en charge de PnP et pm, consultez PnP et gestion de l’alimentation dans les pilotes basés sur UMDF.