Fonction WdfFileObjectWdmGetFileObject (wdffileobject.h)
[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) |