Fonction WdfFileObjectWdmGetFileObject (wdffileobject.h)

  • Article

[S’applique uniquement à KMDF]

La méthode WdfFileObjectWdmGetFileObject retourne l’objet de fichier wdM (Windows Driver Model) associé à un objet de fichier d’infrastructure spécifié.

Syntaxe

PFILE_OBJECT WdfFileObjectWdmGetFileObject(
  [in] WDFFILEOBJECT FileObject
);

Paramètres

[in] FileObject

Handle d’un objet de fichier framework.

Valeur retournée

WdfFileObjectWdmGetFileObject retourne un pointeur vers la structure FILE_OBJECT associée à l’objet de fichier d’infrastructure spécifié, ou NULL s’il n’existe aucun objet de fichier WDM pour l’objet de fichier framework spécifié.

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Le pointeur retourné par la méthode WdfFileObjectWdmGetFileObject est valide jusqu’à ce que l’objet de fichier framework soit supprimé. Si le pilote fournit une fonction EvtCleanupCallback pour l’objet de fichier framework, le pointeur est valide tant que la fonction de rappel n’est pas retournée.

Pour plus d’informations sur les objets de fichier framework, consultez Objets de fichier framework.

Exemples

L’exemple de code suivant obtient un handle pour l’objet de fichier WDM associé à un objet de fichier framework spécifié.

PFILE_OBJECT  pReturnedFileObject;

pReturnedFileObject = WdfFileObjectWdmGetFileObject(fileObject);

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
En-tête wdffileobject.h (include Wdf.h)
Bibliothèque Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.)
IRQL <=DISPATCH_LEVEL
Règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

FILE_OBJECT