Fungsi WdfDpcWdmGetDpc (wdfdpc.h)
[Berlaku untuk KMDF saja]
Metode WdfDpcWdmGetDpc mengembalikan penunjuk ke struktur KDPC yang terkait dengan objek DPC kerangka kerja tertentu.
Sintaks
PKDPC WdfDpcWdmGetDpc(
[in] WDFDPC Dpc
);
Parameter
[in] Dpc
Handel ke objek DPC kerangka kerja.
Nilai kembali
WdfDpcWdmGetDpc mengembalikan penunjuk ke struktur KDPC yang terkait dengan objek DPC kerangka kerja yang ditentukan.
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Keterangan
Kerangka kerja membuat struktur KDPC ketika driver berbasis kerangka kerja memanggil WdfDpcCreate untuk membuat objek DPC.
Driver mungkin memanggil WdfDpcWdmGetDpc dari dalam fungsi panggilan balik EvtDpcFunc-nya .
Penunjuk yang dikembalikan WdfDpcWdmGetDpc valid hingga objek DPC kerangka kerja dihapus. Jika driver menyediakan fungsi EvtCleanupCallback untuk objek DPC kerangka kerja, penunjuk valid hingga fungsi panggilan balik kembali.
Contoh
Contoh kode berikut mengembalikan penunjuk ke struktur KDPC yang terkait dengan objek DPC tertentu. Contoh kode WdfDpcCreate menunjukkan bagaimana objek DPC yang ditentukan dibuat.
PKDPC pWdmDpc;
pWdmDpc = WdfDpcWdmGetDpc(PDevExt->CompleteWriteDpc);
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1,0 |
| Header | wdfdpc.h (termasuk Wdf.h) |
| Pustaka | Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.) |
| IRQL | Tingkat apa pun |
| Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |