Freigeben über


PCI_MSIX_SET_ENTRY Rückruffunktion (wdm.h)

Die SetTableEntry Routine legt die Nachrichten-ID für einen Tabelleneintrag in der MSI-X Hardware-Interrupt-Tabelle fest.

Syntax

PCI_MSIX_SET_ENTRY PciMsixSetEntry;

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

Parameter

[in] Context

Ein Zeiger auf schnittstellenspezifische Kontextinformationen. Der Aufrufer übergibt den Wert, der als Context Member der PCI_MSIX_TABLE_CONFIG_INTERFACE Struktur für die Schnittstelle übergeben wird.

[in] TableEntry

Der Index des Tabelleneintrags in der MSI-X Hardwareunterbruchtabelle.

[in] MessageNumber

Die Nachrichten-ID für den Interrupt. Dieser Wert ist auch der Index für den Eintrag des Interrupts im MessageInfo Member der IO_INTERRUPT_MESSAGE_INFO-Struktur, das die Meldungssignalunterbrechen des Treibers beschreibt. Die IoConnectInterruptEx--Funktion stellt einen Zeiger auf diese Struktur bereit.

Rückgabewert

Die SetTableEntry Routine gibt möglicherweise einen der folgenden NTSTATUS-Werte zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS
Der Vorgang wurde erfolgreich abgeschlossen.
STATUS_INVALID_PARAMETER
Das Gerät verwendet keine MSI-X- oder die TableEntry- oder MessageNumber Parameter entsprechen nicht den Unterbrechungsressourcen, die dem Gerät zugewiesen sind.

Bemerkungen

Standardmäßig weist das Betriebssystem den Index des Tabelleneintrags als Nachrichten-ID für den Interrupt zu. Wenn mehr Tabelleneinträge als Nachrichten vorhanden sind, legt das System die verbleibenden Tabelleneinträge so fest, dass sie der Meldung Null entsprechen. Der Treiber kann die SetTableEntry Routine verwenden, um eine andere Nachrichten-ID zuzuweisen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar in Windows Vista mit Service Pack 1 (SP1), Windows Server 2008 und höheren Versionen des Windows-Betriebssystems.
Zielplattform- Desktop
Header- wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL- <= DIRQL

Siehe auch

IO_INTERRUPT_MESSAGE_INFO

IoConnectInterruptEx-

PCI_MSIX_TABLE_CONFIG_INTERFACE