Création de fichiers par une cible d’E/S USB

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.

Lors de son initialisation, la cible d’E/S USB crée un objet de fichier intra-pile, qui représente une session par défaut que la cible d’E/S USB conserve ouverte. Pour plus d’informations sur un objet de fichier intra-pile, consultez Création d’un objet file pour gérer les E/S. La cible d’E/S USB ou ses enfants cibles de canal USB utilisent cet objet de fichier pour envoyer toutes les E/S qu’ils proviennent (par exemple, E/S pour obtenir le descripteur de configuration USB).

Le pilote peut utiliser cet objet de fichier intra-pile dans les fonctions de format (par exemple, le pilote peut passer un pointeur vers cet objet de fichier vers le paramètre pFile dans un appel à la méthode IWDFIoTarget::FormatRequestForRead ) si le pilote doit envoyer des E/S sur la session par défaut de cet objet de fichier. Pour obtenir l’objet de fichier intra-pile, le pilote peut appeler la méthode IWDFIoTarget::GetTargetFile .

Cet objet de fichier intra-pile est fermé lorsque la cible d’E/S est supprimée de manière explicite, lorsque le pilote appelle la méthode IWDFObject::D eleteWdfObject sur la cible d’E/S, ou implicitement, lorsque le parent de la cible d’E/S est supprimé.

Si une E/S reste en suspens sur cet objet de fichier intra-pile au moment de la suppression de l’appareil, cet objet de fichier ne parvient pas à se fermer et UMDF génère un arrêt du pilote. Pour plus d’informations, consultez Création et utilisation d’objets de fichier Driver-Created.