Méthode IWDFDevice ::CreateWdfFile (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 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

Voir aussi

IWDFDevice

IWDFDriverCreatedFile