Méthode IWDFDevice ::CreateWdfFile (wudfddi.h)
[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 CreateWdfFile crée un objet file pour un pilote à utiliser.
Syntaxe
HRESULT CreateWdfFile(
[in, optional] LPCWSTR pcwszFileName,
[out] IWDFDriverCreatedFile **ppFile
);
Paramètres
[in, optional] pcwszFileName
Pointeur vers une chaîne terminée par null qui contient le nom du fichier à partir duquel créer un objet de fichier. Ce paramètre est facultatif. Le pilote peut passer la valeur NULL si le pilote n’a pas besoin de créer l’objet fichier à partir d’un nom de fichier. Si le pilote doit fournir un nom, la chaîne que le pilote transmet ne doit pas contenir de caractères de séparation de chemin (« / » ou « \ »).
[out] ppFile
Pointeur vers une mémoire tampon qui reçoit un pointeur vers l’interface IWDFDriverCreatedFile pour l’objet de fichier créé par le pilote.
Valeur retournée
CreateWdfFile retourne S_OK si l’opération réussit. Sinon, cette méthode retourne l’un des codes d’erreur définis dans Winerror.h.
Remarques
Pour plus d’informations sur le moment où un pilote UMDF utilise CreateWdfFile pour gérer les E/S, consultez Création d’un objet File pour gérer les E/S.
Pour plus d’informations sur le moment où un pilote UMDF peut utiliser CreateWdfFile pour éviter un déséquilibre entre les notifications de création et de fermeture d’un pilote, consultez Prévention d’un déséquilibre de la création et de la fermeture des notifications à un pilote.
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 |