Fungsi WdfDriverWdmGetDriverObject (wdfdriver.h)
[Hanya berlaku untuk KMDF]
Metode WdfDriverWdmGetDriverObject mengambil penunjuk ke objek driver Windows Driver Model (WDM) yang terkait dengan objek driver kerangka kerja tertentu.
Sintaks
PDRIVER_OBJECT WdfDriverWdmGetDriverObject(
[in] WDFDRIVER Driver
);
Parameter
[in] Driver
Handel ke objek driver kerangka kerja driver yang diperoleh driver dari panggilan sebelumnya ke WdfDriverCreate atau WdfGetDriver.
Nilai kembali
WdfDriverWdmGetDriverObject mengembalikan penunjuk ke struktur DRIVER_OBJECT . Pemeriksaan bug sistem terjadi jika handel Driver tidak valid.
Keterangan
Penunjuk yang dikembalikan metode WdfDriverWdmGetDriverObject valid hingga objek driver kerangka kerja dihapus. Jika driver menyediakan fungsi EvtCleanupCallback untuk objek driver kerangka kerja, penunjuk valid hingga fungsi panggilan balik kembali.
Contoh
Contoh kode berikut mendapatkan penunjuk ke objek driver WDM yang terkait dengan objek driver kerangka kerja tertentu.
PDRIVER_OBJECT pDrvObj;
pDrvObj = WdfDriverWdmGetDriverObject(Driver);
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Versi KMDF minimum | 1,0 |
Header | wdfdriver.h (termasuk Wdf.h) |
Pustaka | Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.) |
IRQL | <= DISPATCH_LEVEL |
Aturan kepatuhan DDI | DriverCreate(kmdf) |