PCI_MSIX_SET_ENTRY funzione di callback (wdm.h)

La routine SetTableEntry imposta l'ID messaggio per una voce di tabella nella tabella di interruzione hardware MSI-X.

Sintassi

PCI_MSIX_SET_ENTRY PciMsixSetEntry;

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

Parametri

[in] Context

Puntatore a informazioni di contesto specifiche dell'interfaccia. Il chiamante passa il valore passato come membro Contesto della struttura di PCI_MSIX_TABLE_CONFIG_INTERFACE per l'interfaccia.

[in] TableEntry

Indice della voce della tabella nella tabella di interruzione hardware MSI-X.

[in] MessageNumber

ID messaggio per l'interruzione. Questo valore è anche l'indice per la voce dell'interruzione nel membro MessageInfo della struttura IO_INTERRUPT_MESSAGE_INFO che descrive gli interruzioni del messaggio del driver. La funzione IoConnectInterruptEx fornisce un puntatore a questa struttura.

Valore restituito

La routine SetTableEntry potrebbe restituire uno dei valori NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	Operazione riuscita.
STATUS_INVALID_PARAMETER	Il dispositivo non usa MSI-X o i parametri TableEntry o MessageNumber non corrispondono alle risorse di interruzione assegnate al dispositivo.

Commenti

Per impostazione predefinita, il sistema operativo assegna l'indice della voce della tabella come ID messaggio per l'interruzione. Se sono presenti più voci di tabella rispetto ai messaggi, il sistema imposta le voci di tabella rimanenti in modo che corrispondano a zero messaggi. Il driver può usare la routine SetTableEntry per assegnare un ID messaggio diverso.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista con Service Pack 1 (SP1), Windows Server 2008 e versioni successive del sistema operativo Windows.
Piattaforma di destinazione	Desktop
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL	<= DIRQL

Vedi anche

IO_INTERRUPT_MESSAGE_INFO

IoConnectInterruptEx

PCI_MSIX_TABLE_CONFIG_INTERFACE