WdfFileObjectWdmGetFileObject, fonction (wdffileobject.h)

[S’applique uniquement à KMDF]

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

Syntaxe

PFILE_OBJECT WdfFileObjectWdmGetFileObject(
  [in] WDFFILEOBJECT FileObject
);

Paramètres

[in] FileObject

Handle d’un objet de fichier framework.

Valeur de retour

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

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Remarques

Pointeur que la méthode WdfFileObjectWdmGetFileObject retourne est valide jusqu’à ce que l’objet de fichier framework soit supprimé. Si le pilote fournit un EvtCleanupCallback fonction pour l’objet de fichier framework, le pointeur est valide jusqu’à ce que la fonction de rappel retourne.

Pour plus d’informations sur les objets de fichier framework, consultez Framework File Objects.

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);

Spécifications

Voir aussi

FILE_OBJECT