struktur WUDF_INTERRUPT_CONFIG (wudfinterrupt.h)
[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]
Struktur WUDF_INTERRUPT_CONFIG berisi informasi konfigurasi untuk gangguan perangkat.
Sintaks
typedef struct _WUDF_INTERRUPT_CONFIG {
ULONG Size;
WDF_TRI_STATE ShareVector;
BOOLEAN AutomaticSerialization;
PFN_WUDF_INTERRUPT_ISR OnInterruptIsr;
PFN_WUDF_INTERRUPT_ENABLE OnInterruptEnable;
PFN_WUDF_INTERRUPT_DISABLE OnInterruptDisable;
PFN_WUDF_INTERRUPT_WORKITEM OnInterruptWorkItem;
PCM_PARTIAL_RESOURCE_DESCRIPTOR InterruptRaw;
PCM_PARTIAL_RESOURCE_DESCRIPTOR InterruptTranslated;
} WUDF_INTERRUPT_CONFIG, *PWUDF_INTERRUPT_CONFIG;
Anggota
Size
Ukuran, dalam byte, dari struktur ini.
ShareVector
Nilai yang ditik WDF_TRI_STATE. Jika nilai ini adalah WdfTrue, vektor interupsi dapat dibagikan. Jika nilainya adalah WdfFalse, vektor interupsi tidak dapat dibagikan. Jika nilainya adalah WdfDefault dan interupsi dipicu tingkat, manajer Plug and Play menggunakan nilai pengemudi bus. Jika nilainya adalah WdfDefault dan gangguan tidak dipicu tingkat, vektor interupsi tidak dapat dibagikan.
AutomaticSerialization
Nilai Boolean yang, jika TRUE, menunjukkan bahwa kerangka kerja akan menyinkronkan eksekusi fungsi panggilan balik OnInterruptWorkItem objek interupsi dengan fungsi panggilan balik lain yang menggunakan fungsi sinkronisasi panggilan balik kerangka kerja. Lihat Keterangan untuk informasi selengkapnya.
OnInterruptIsr
Penunjuk ke fungsi panggilan balik OnInterruptIsr driver, atau NULL.
OnInterruptEnable
Penunjuk ke fungsi panggilan balik OnInterruptEnable driver, atau NULL.
OnInterruptDisable
Penunjuk ke fungsi panggilan balik OnInterruptDisable driver, atau NULL.
OnInterruptWorkItem
Penunjuk ke fungsi panggilan balik OnInterruptWorkItem driver, atau NULL.
InterruptRaw
Penunjuk ke struktur CM_PARTIAL_RESOURCE_DESCRIPTOR yang menjelaskan sumber daya mentah yang ditetapkan sistem untuk interupsi. Anggota ini hanya digunakan jika interupsi dibuat dalam panggilan balik OnPrepareHardware .
InterruptTranslated
Penunjuk ke struktur CM_PARTIAL_RESOURCE_DESCRIPTOR yang menjelaskan sumber daya yang diterjemahkan yang ditetapkan sistem ke interupsi. Anggota ini hanya digunakan jika interupsi dibuat dalam panggilan balik OnPrepareHardware .
Keterangan
Struktur WUDF_INTERRUPT_CONFIG digunakan sebagai input ke IWDFDevice3::CreateInterrupt.
Untuk menginisialisasi struktur WUDF_INTERRUPT_CONFIG , driver Anda harus terlebih dahulu memanggil WUDF_INTERRUPT_CONFIG_INIT lalu mengisi anggota struktur yang tidak WUDF_INTERRUPT_CONFIG_INIT inisialisasi.
Sebelum mengatur AutomaticSerialization ke TRUE, driver harus memanggil IWDFDeviceInitialize::SetLockingConstraint dengan parameter LockType yang diatur ke WdfDeviceLevel.
Driver Anda harus menyertakan Wudfwdm.h, yang berisi definisi CM_PARTIAL_RESOURCE_DESCRIPTOR.
UMDF mendukung gangguan berbasis garis yang dipicu tepi dan interupsi bertanda pesan (MSI) pada semua sistem operasi yang didukung kerangka kerja. Karena jenis sumber daya interupsi ini tidak dibagikan, driver yang menggunakannya harus mengatur anggota ShareVector dari struktur ini ke WdfFalse atau WdfUseDefault. Jika driver menentukan nilai ShareVector yang tidak valid, driver gagal memulai.
Persyaratan
Persyaratan | Nilai |
---|---|
Versi UMDF minimum | 1.11 |
Header | wudfinterrupt.h |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk