Fungsi WdfFileObjectGetDevice (wdffileobject.h)

[Berlaku untuk KMDF dan UMDF]

Metode WdfFileObjectGetDevice mengembalikan objek perangkat kerangka kerja yang terkait dengan objek file kerangka kerja tertentu.

Sintaks

WDFDEVICE WdfFileObjectGetDevice(
  [in] WDFFILEOBJECT FileObject
);

Parameter

[in] FileObject

Handel ke objek file kerangka kerja.

Nilai kembali

WdfFileObjectGetDevice mengembalikan handel ke objek perangkat kerangka kerja yang terkait dengan objek file kerangka kerja yang ditentukan.

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

Keterangan

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

Contoh

Contoh kode berikut menunjukkan bagaimana fungsi panggilan balik EvtFileClose dapat memperoleh objek perangkat kerangka kerja yang terkait dengan objek file kerangka kerja tertentu.

VOID
MyEvtFileClose(
    IN WDFFILEOBJECT  FileObject
    )
{
    WDFDEVICE device;

    device = WdfFileObjectGetDevice(FileObject);
...
}

Persyaratan

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