Création d’un objet File pour gérer les E/S

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 sont disponibles dans la mise à jour des exemples de pilotes Windows 11, version 22H2 - Mai 2022.

Pour plus d’informations, consultez Prise en main avec UMDF.

Lorsqu’une application ouvre un handle de fichier, le gestionnaire d’E/S crée un objet file. L’infrastructure crée à son tour un objet de fichier d’infrastructure pour représenter l’objet de fichier du gestionnaire d’E/S.

Sauf si le pilote définit la directive UmdfFileObjectPolicy sur AllowNullAndUnknownFileObjects, UMDF exige que chaque demande d’E/S soit associée à un objet fichier. Pour plus d’informations sur cette directive, consultez Spécification de directives WDF dans les fichiers INF.

Si votre pilote UMDF envoie des E/S indépendantes de l’application au pilote suivant de la pile (par exemple, lors de l’initialisation de l’appareil ou pour recevoir une notification des événements de périphérique), le pilote doit créer son propre objet de fichier à associer à la demande.

Les sections suivantes décrivent les différences entre les objets de fichier créés par le pilote et les objets de fichier créés par l’application, ainsi que la façon dont le pilote crée et utilise un objet fichier.