PCI_MSIX_SET_ENTRY Rückruffunktion (wdm.h)
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 |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
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 |