PCI_MSIX_SET_ENTRY Rückruffunktion (wdm.h)

  • Artikel

Die SetTableEntry-Routine legt die Meldungs-ID für einen Tabelleneintrag in der MSI-X-Hardwareunterbrechungstabelle 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 Kontextelement der PCI_MSIX_TABLE_CONFIG_INTERFACE-Struktur für die Schnittstelle übergeben wird.

[in] TableEntry

Der Index des Tabelleneintrags in der MSI-X-Hardwareunterbrechungstabelle.

[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 , die die vom Treiber mit Nachrichten signalisierten Interrupts 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 Parameter TableEntry oder MessageNumber entsprechen nicht interrupt-Ressourcen, die dem Gerät zugewiesen sind.

Hinweise

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 restlichen Tabelleneinträge so fest, dass sie Meldung 0 (Null) entsprechen. Der Treiber kann die SetTableEntry-Routine verwenden, um eine andere Nachrichten-ID zuzuweisen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (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 (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
IRQL <= DIRQL

Weitere Informationen

IO_INTERRUPT_MESSAGE_INFO

IoConnectInterruptEx

PCI_MSIX_TABLE_CONFIG_INTERFACE