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)

Lihat juga

EvtDevicePrepareHardware

EvtDeviceReleaseHardware

WDF_INTERRUPT_INFO

WDF_INTERRUPT_INFO_INIT