Fungsi WdfRequestGetFileObject (wdfrequest.h)

Artikel
02/27/2024

[Berlaku untuk KMDF dan UMDF]

Metode WdfRequestGetFileObject mengambil objek file kerangka kerja yang terkait dengan permintaan I/O tertentu.

Sintaks

WDFFILEOBJECT WdfRequestGetFileObject(
  [in] WDFREQUEST Request
);

Parameter

[in] Request

Handel ke objek permintaan kerangka kerja.

Nilai kembali

WdfRequestGetFileObject mengembalikan handel ke objek file kerangka kerja, jika kerangka kerja telah membuat objek file untuk permintaan yang ditentukan. Jika tidak, metode ini mengembalikan NULL. (Driver biasanya menguji nilai pengembalian NULL hanya jika menetapkan bendera bit WdfFileObjectCanBeOptional dalam struktur WDF_FILEOBJECT_CONFIG .)

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Keterangan

Metode WdfRequestGetFileObject mengembalikan NULL jika:

Driver Anda belum memanggil WdfDeviceInitSetFileObjectConfig dan menentukan nilai WDF_FILEOBJECT_CLASS yang menyebabkan kerangka kerja membuat objek file.
Driver lain mengirim permintaan kontrol baca, tulis, atau I/O ke driver Anda tanpa terlebih dahulu mengirim jenis permintaan WdfRequestTypeCreate.

Untuk informasi selengkapnya tentang objek file WdfRequestGetFileObject dan kerangka kerja, lihat Objek File Kerangka Kerja.

Contoh

Contoh kode berikut mendapatkan objek file permintaan I/O lalu memanggil rutinitas yang ditentukan driver yang mendapatkan penunjuk ke ruang konteks objek file.

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

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Versi UMDF minimum	2.0
Header	wdfrequest.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<=DISPATCH_LEVEL
Aturan kepatuhan DDI	DriverCreate(kmdf), FileObjectConfigured(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

WDF_FILEOBJECT_CLASS

WdfDeviceInitSetFileObjectConfig