struktur NDIS_MINIPORT_INTERRUPT_CHARACTERISTICS (ndis.h)

Artikel
08/07/2023

Driver miniport NDIS mendefinisikan karakteristik interupsinya dalam struktur NDIS_MINIPORT_INTERRUPT_CHARACTERISTICS dan meneruskan struktur ke Fungsi NdisMRegisterInterruptEx .

Sintaks

typedef struct _NDIS_MINIPORT_INTERRUPT_CHARACTERISTICS {
  NDIS_OBJECT_HEADER                     Header;
  MINIPORT_ISR_HANDLER                   InterruptHandler;
  MINIPORT_INTERRUPT_DPC_HANDLER         InterruptDpcHandler;
  MINIPORT_DISABLE_INTERRUPT_HANDLER     DisableInterruptHandler;
  MINIPORT_ENABLE_INTERRUPT_HANDLER      EnableInterruptHandler;
  BOOLEAN                                MsiSupported;
  BOOLEAN                                MsiSyncWithAllMessages;
  MINIPORT_MSI_ISR_HANDLER               MessageInterruptHandler;
  MINIPORT_MSI_INTERRUPT_DPC_HANDLER     MessageInterruptDpcHandler;
  MINIPORT_DISABLE_MSI_INTERRUPT_HANDLER DisableMessageInterruptHandler;
  MINIPORT_ENABLE_MSI_INTERRUPT_HANDLER  EnableMessageInterruptHandler;
  NDIS_INTERRUPT_TYPE                    InterruptType;
  PIO_INTERRUPT_MESSAGE_INFO             MessageInfoTable;
} NDIS_MINIPORT_INTERRUPT_CHARACTERISTICS, *PNDIS_MINIPORT_INTERRUPT_CHARACTERISTICS;

Anggota

Header

Struktur NDIS_OBJECT_HEADER untuk struktur NDIS_MINIPORT_INTERRUPT_CHARACTERISTICS. Atur anggota Jenis struktur yang ditentukan Header ke NDIS_OBJECT_TYPE_MINIPORT_INTERRUPT, anggota Revisi ke NDIS_MINIPORT_INTERRUPT_REVISION_1, dan anggota Ukuran ke NDIS_SIZEOF_MINIPORT_INTERRUPT_CHARACTERISTICS_REVISION_1.

InterruptHandler

Titik masuk untuk fungsi MiniportInterrupt yang terkait dengan gangguan ini.

InterruptDpcHandler

Titik masuk untuk fungsi MiniportInterruptDPC yang terkait dengan gangguan ini.

DisableInterruptHandler

Titik masuk untuk Fungsi MiniportDisableInterruptEx .

EnableInterruptHandler

Titik masuk untuk Fungsi MiniportEnableInterruptEx .

MsiSupported

Atur anggota ini ke TRUE jika driver miniport mendukung fungsi layanan interupsi bersinyali pesan (MSI). Driver miniport harus menyediakan titik masuk untuk fungsi layanan MSI.

Mengatur nilai ini ke FALSE menunjukkan bahwa MSI tidak didukung. Titik entri fungsi layanan MSI harus diatur ke NULL.

MsiSyncWithAllMessages

Atur anggota ini ke TRUE jika driver miniport harus menserialisasikan semua fungsi layanan MSI.

Mengatur nilai ini ke TRUE dapat menurunkan performa interupsi. Ini lebih efisien untuk beberapa fungsi layanan interupsi yang menangani pesan yang berbeda untuk berjalan secara bersamaan.

MessageInterruptHandler

Titik masuk untuk Fungsi MiniportMessageInterrupt , jika ada, yang terkait dengan gangguan ini. Jika driver tidak mendukung gangguan pesan, atur anggota ini ke NULL.

MessageInterruptDpcHandler

Titik masuk untuk Fungsi MiniportMessageInterruptDPC , jika ada, yang terkait dengan gangguan ini. Jika driver tidak mendukung gangguan bertanda pesan, atur anggota ini ke NULL.

DisableMessageInterruptHandler

Titik masuk untuk Fungsi MiniportDisableMessageInterrupt , jika ada. Jika driver tidak mendukung interupsi sinyal pesan, atur anggota ini ke NULL.

EnableMessageInterruptHandler

Titik masuk untuk Fungsi MiniportEnableMessageInterrupt , jika ada. Jika driver tidak mendukung gangguan bertanda pesan, atur anggota ini ke NULL.

InterruptType

Variabel jenis NDIS_INTERRUPT_TYPE. NDIS mengatur variabel ini untuk menunjukkan jenis gangguan mana yang diberikannya kepada driver miniport. Jika driver mendukung MSI, driver harus memeriksa nilai ini jika NdisMRegisterInterruptEx mengembalikan NDIS_STATUS_SUCCESS. Jika InterruptType diatur ke NDIS_CONNECT_LINE_BASED, maka NDIS memberi driver interupsi berbasis baris, yang dapat terjadi bahkan jika driver mendukung gangguan yang disinyalir pesan. Jika InterruptType diatur ke NDIS_CONNECT_MESSAGE_BASED, maka NDIS memberi driver interupsi bersinyali pesan. Dalam hal ini, driver dapat mengakses MessageInfoTable untuk mendapatkan informasi interupsi.

MessageInfoTable

Penunjuk yang disediakan NDIS ke IO_INTERRUPT_MESSAGE_INFO struktur.

Jika InterruptTypeNDIS_CONNECT_MESSAGE_BASED, NDIS menginisialisasi struktur IO_INTERRUPT_MESSAGE_INFO dengan informasi tentang interupsi dan mengatur MessageInfoTable ke penunjuk ke struktur. Driver miniport tidak boleh memodifikasi struktur.
Jika InterruptTypeNDIS_CONNECT_LINE_BASED, MessageInfoTable harus NULL.

Keterangan

Driver miniport memanggil fungsi NdisMRegisterInterruptEx untuk mendaftarkan interupsi. Driver mengalokasikan dan menginisialisasi struktur NDIS_MINIPORT_INTERRUPT_CHARACTERISTICS untuk menentukan karakteristik interupsi dan titik masuk handler dan meneruskan struktur ke NdisMRegisterInterruptEx.