Freigeben über


WdfRequestGetFileObject-Funktion (wdfrequest.h)

[Gilt für KMDF und UMDF]

Die WdfRequestGetFileObject-Methode ruft das Frameworkdateiobjekt ab, das einer angegebenen E/A-Anforderung zugeordnet ist.

Syntax

WDFFILEOBJECT WdfRequestGetFileObject(
  [in] WDFREQUEST Request
);

Parameter

[in] Request

Ein Handle für ein Frameworkanforderungsobjekt.

Rückgabewert

WdfRequestGetFileObject gibt ein Handle an das Frameworkdateiobjekt zurück, wenn das Framework ein Dateiobjekt für die angegebene Anforderung erstellt hat. Andernfalls gibt diese Methode NULL zurück. (Ein Treiber testet in der Regel nur dann auf einen NULL-Rückgabewert, wenn er das WdfFileObjectCanBeOptional-Bitflag in der WDF_FILEOBJECT_CONFIG-Struktur festlegt.)

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

Hinweise

Die WdfRequestGetFileObject-Methode gibt NULL zurück, wenn:

Weitere Informationen zu WdfRequestGetFileObject und Frameworkdateiobjekten finden Sie unter Frameworkdateiobjekte.

Beispiele

Im folgenden Codebeispiel wird das Dateiobjekt einer E/A-Anforderung abgerufen und dann eine vom Treiber definierte Routine aufgerufen, die einen Zeiger auf den Kontextbereich des Dateiobjekts abruft.

VOID
MyEvtIoWrite(
    IN WDFQUEUE  Queue,
    IN WDFREQUEST  Request,
    IN size_t  Length
    )
{
    WDFFILEOBJECT  fileObject;
    PFILE_OPEN_CONTEXT  pOpenContext;

    fileObject = WdfRequestGetFileObject(Request);
    pOpenContext = GetFileObjectContext(fileObject)->OpenContext;
}

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
UMDF-Mindestversion 2.0
Kopfzeile wdfrequest.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), FileObjectConfigured(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WDF_FILEOBJECT_CLASS

WdfDeviceInitSetFileObjectConfig