Fungsi WdfDpcWdmGetDpc (wdfdpc.h)

Artikel
02/29/2024

[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)