Fungsi WdfFileObjectWdmGetFileObject (wdffileobject.h)

[Berlaku untuk KMDF saja]

Metode WdfFileObjectWdmGetFileObject mengembalikan objek file Windows Driver Model (WDM) yang terkait dengan objek file kerangka kerja tertentu.

Sintaks

PFILE_OBJECT WdfFileObjectWdmGetFileObject(
  [in] WDFFILEOBJECT FileObject
);

Parameter

[in] FileObject

Handel ke objek file kerangka kerja.

Nilai kembali

WdfFileObjectWdmGetFileObject mengembalikan penunjuk ke struktur FILE_OBJECT yang terkait dengan objek file kerangka kerja yang ditentukan, atau NULL jika tidak ada objek file WDM untuk objek file kerangka kerja yang ditentukan.

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

Keterangan

Penunjuk yang dikembalikan metode WdfFileObjectWdmGetFileObject valid hingga objek file kerangka kerja dihapus. Jika driver menyediakan fungsi EvtCleanupCallback untuk objek file kerangka kerja, penunjuk valid hingga fungsi panggilan balik kembali.

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

Contoh

Contoh kode berikut mendapatkan handel ke objek file WDM yang terkait dengan objek file kerangka kerja tertentu.

PFILE_OBJECT  pReturnedFileObject;

pReturnedFileObject = WdfFileObjectWdmGetFileObject(fileObject);

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Header	wdffileobject.h (termasuk Wdf.h)
Pustaka	Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL	<=DISPATCH_LEVEL
Aturan kepatuhan DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

FILE_OBJECT