Bagikan melalui


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

IWDFDevice3::CreateInterrupt

IWDFDeviceInitialize::SetLockingConstraint

WUDF_INTERRUPT_CONFIG_INIT