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 |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
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 |