WdfFileObjectGetDevice-Funktion (wdffileobject.h)

Artikel
03/22/2025

[Gilt für KMDF und UMDF]

Die WdfFileObjectGetDevice--Methode gibt das Framework-Geräteobjekt zurück, das einem angegebenen Frameworkdateiobjekt zugeordnet ist.

Syntax

WDFDEVICE WdfFileObjectGetDevice(
  [in] WDFFILEOBJECT FileObject
);

Die Parameter

[in] FileObject

Ein Handle zu einem Framework-Dateiobjekt.

Rückgabewert

WdfFileObjectGetDevice gibt ein Handle an das Framework-Geräteobjekt zurück, das dem angegebenen Frameworkdateiobjekt zugeordnet ist.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Weitere Informationen zu Framework-Dateiobjekten finden Sie unter Framework File Objects.

Beispiele

Das folgende Codebeispiel zeigt, wie eine EvtFileClose- Rückruffunktion das Framework-Geräteobjekt abrufen kann, das einem angegebenen Frameworkdateiobjekt zugeordnet ist.

VOID
MyEvtFileClose(
    IN WDFFILEOBJECT  FileObject
    )
{
    WDFDEVICE device;

    device = WdfFileObjectGetDevice(FileObject);
...
}

Anforderungen

Anforderung	Wert
Zielplattform	universell
Minimale KMDF-Version	1.0
Mindest-UMDF-Version	2.0
Kopfzeile	wdffileobject.h (einschließen Wdf.h)
Bibliothek	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Freigeben über