Fonction WdfFileObjectGetDevice (wdffileobject.h)

Article
02/27/2024

[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 retournée

WdfFileObjectGetDevice retourne un handle à l’objet d’appareil framework associé à l’objet de fichier d’infrastructure spécifié.

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

Remarques

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

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

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
Version UMDF minimale	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)

Partager via