PCI_MSIX_SET_ENTRY fungsi panggilan balik (wdm.h)

  • Artikel

Rutinitas SetTableEntry mengatur ID pesan untuk entri tabel dalam tabel interupsi perangkat keras MSI-X.

Sintaks

PCI_MSIX_SET_ENTRY PciMsixSetEntry;

NTSTATUS PciMsixSetEntry(
  [in] PVOID Context,
  [in] ULONG TableEntry,
  [in] ULONG MessageNumber
)
{...}

Parameter

[in] Context

Penunjuk ke informasi konteks khusus antarmuka. Penelepon meneruskan nilai yang diteruskan sebagai anggota Konteks dari struktur PCI_MSIX_TABLE_CONFIG_INTERFACE untuk antarmuka.

[in] TableEntry

Indeks entri tabel dalam tabel gangguan perangkat keras MSI-X.

[in] MessageNumber

ID pesan untuk interupsi. Nilai ini juga merupakan indeks untuk entri interupsi di anggota MessageInfo dari struktur IO_INTERRUPT_MESSAGE_INFO yang menjelaskan gangguan yang disinyalkan pesan driver. Fungsi IoConnectInterruptEx memasok pointer ke struktur ini.

Nilai kembali

Rutinitas SetTableEntry mungkin mengembalikan salah satu nilai NTSTATUS berikut ini:

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Operasi berhasil diselesaikan.
STATUS_INVALID_PARAMETER
 Perangkat tidak menggunakan MSI-X, atau parameter TableEntry atau MessageNumber tidak sesuai dengan sumber daya interupsi yang ditetapkan ke perangkat.

Keterangan

Secara default, sistem operasi menetapkan indeks entri tabel sebagai ID pesan untuk interupsi. Jika ada lebih banyak entri tabel daripada pesan, sistem mengatur entri tabel yang tersisa agar sesuai dengan nol pesan. Driver dapat menggunakan rutinitas SetTableEntry untuk menetapkan ID pesan yang berbeda.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows Vista dengan Paket Layanan 1 (SP1), Windows Server 2008, dan versi sistem operasi Windows yang lebih baru.
Target Platform Desktop
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
IRQL <= DIRQL

Lihat juga

IO_INTERRUPT_MESSAGE_INFO

IoConnectInterruptEx

PCI_MSIX_TABLE_CONFIG_INTERFACE