IWDFIoTarget ::GetTargetFile, méthode (wudfddi.h)
Avertissement
UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 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 de 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
Aucun
Remarques
Si un objet de fichier framework est associé à un objet cible d’E/S, l’infrastructure inclut l’objet de fichier avec les demandes d’E/S envoyées par le pilote à 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 requête a démarré ou un nouveau fichier.
La cible d’E/S par défaut n’a pas d’objet de fichier. Par conséquent, 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.
Exigences
Exigence | Valeur |
---|---|
fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
plateforme cible | Bureau |
version minimale de UMDF | 1.5 |
d’en-tête | wudfddi.h (include Wudfddi.h) |
DLL | WUDFx.dll |
Voir aussi
- IWDFFile
- utilisation de cibles d’E/S dans les UMDF
- IWDFIoTarget
- IWDFIoTarget ::FormatRequestForWrite