Fungsi WdfInterruptGetInfo (wdfinterrupt.h)
[Berlaku untuk KMDF dan UMDF]
Metode WdfInterruptGetInfo mengambil informasi tentang gangguan tertentu.
Sintaks
void WdfInterruptGetInfo(
[in] WDFINTERRUPT Interrupt,
[in, out] PWDF_INTERRUPT_INFO Info
);
Parameter
[in] Interrupt
Handel ke objek interupsi.
[in, out] Info
Penunjuk ke struktur WDF_INTERRUPT_INFO yang dialokasikan penelepon yang telah diinisialisasi dengan memanggil WDF_INTERRUPT_INFO_INIT.
Nilai kembali
Tidak ada
Keterangan
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Metode WdfInterruptGetInfo dapat memperoleh informasi interupsi hanya jika driver Anda memanggilnya setelah kerangka kerja memanggil fungsi panggilan balik EvtDevicePrepareHardware driver dan sebelum kerangka kerja telah memanggil fungsi panggilan balik EvtDeviceReleaseHardware driver.
Setelah WdfInterruptGetInfo kembali, driver dapat mengidentifikasi objek interupsi tingkat pasif dengan memeriksa anggota Irql dari struktur WDF_INTERRUPT_INFO . Untuk objek interupsi tingkat pasif, nilai ini PASSIVE_LEVEL.
Untuk informasi tentang urutan fungsi panggilan balik driver dipanggil, lihat Skenario PnP dan Manajemen Daya.
Untuk informasi selengkapnya tentang penanganan gangguan dalam driver berbasis kerangka kerja, lihat Menangani Gangguan Perangkat Keras.
Contoh
Contoh kode berikut menginisialisasi struktur WDF_INTERRUPT_INFO dan memanggil WdfInterruptGetInfo.
WDF_INTERRUPT_INFO Info;
WDF_INTERRUPT_INFO_INIT(&Info);
WdfInterruptGetInfo(
Interrupt,
&Info
);
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1,0 |
| Versi UMDF minimum | 2.0 |
| Header | wdfinterrupt.h (termasuk Wdf.h) |
| Pustaka | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| Aturan kepatuhan DDI | DriverCreate(kmdf) |