WdfFileObjectGetDevice-Funktion (wdffileobject.h)

  • Artikel

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

Parameter

[in] FileObject

Ein Handle für ein Frameworkdateiobjekt.

Rückgabewert

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

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Weitere Informationen zu Frameworkdateiobjekten finden Sie unter Frameworkdateiobjekte.

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
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdffileobject.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)