Partager via


WdfFileObjectGetDevice, fonction (wdffileobject.h)

[S’applique à KMDF et UMDF]

La méthode WdfFileObjectGetDevice retourne l’objet d’appareil framework associé à un objet de fichier framework spécifié.

Syntaxe

WDFDEVICE WdfFileObjectGetDevice(
  [in] WDFFILEOBJECT FileObject
);

Paramètres

[in] FileObject

Handle d’un objet de fichier framework.

Valeur de retour

WdfFileObjectGetDevice retourne un handle à l’objet d’appareil framework associé à 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

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

Exemples

L’exemple de code suivant montre comment une fonction de rappel EvtFileClose peut obtenir l’objet d’appareil framework associé à un objet de fichier framework spécifié.

VOID
MyEvtFileClose(
    IN WDFFILEOBJECT  FileObject
    )
{
    WDFDEVICE device;

    device = WdfFileObjectGetDevice(FileObject);
...
}

Spécifications

Besoin Valeur
plateforme cible Universel
version minimale de KMDF 1.0
version minimale de UMDF 2.0
En-tête wdffileobject.h (include Wdf.h)
Bibliothèque Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)