Partager via

Méthode IWDFIoTarget ::GetTargetFile (wudfddi.h)

  • Article

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. Pour plus d’informations, consultez Prise en main avec UMDF.

La méthode GetTargetFile récupère l’objet de fichier framework associé à l’objet cible d’E/S.

Syntaxe

void GetTargetFile(
  [out] IWDFFile **ppWdfFile
);

Paramètres

[out] ppWdfFile

Pointeur vers une mémoire tampon qui reçoit un pointeur vers l’interface IWDFFile pour l’objet de fichier de la cible d’E/S.

Valeur de retour

None

Remarques

Si un objet de fichier framework est associé à un objet cible d’E/S, l’infrastructure inclut l’objet fichier avec les demandes d’E/S que le pilote envoie à l’objet cible d’E/S.

Lorsqu’un pilote met en forme une requête d’E/S, un objet cible d’E/S permet au pilote d’utiliser le même fichier que celui avec lequel la demande a démarré ou un nouveau fichier.

La cible d’E/S par défaut n’ayant aucun objet de fichier, un appel à GetTargetFile pour la cible d’E/S par défaut récupère NULL.

Pour plus d’informations sur les cibles d’E/S, consultez Utilisation de cibles d’E/S dans UMDF.

Exemples

Pour obtenir un exemple de code montrant comment utiliser la méthode GetTargetFile , consultez IWDFIoTarget ::FormatRequestForWrite.

Configuration requise

Condition requise Valeur
Fin de la prise en charge Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
Version UMDF minimale 1.5
En-tête wudfddi.h (inclure Wudfddi.h)
DLL WUDFx.dll

Voir aussi