Condividi tramite


PCI_MSIX_SET_ENTRY funzione di callback (wdm.h)

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

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 Context della struttura PCI_MSIX_TABLE_CONFIG_INTERFACE per l'interfaccia.

[in] TableEntry

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

[in] MessageNumber

ID del messaggio per l'interrupt. Questo valore è anche l'indice per la voce dell'interrupt nel membro MessageInfo della struttura IO_INTERRUPT_MESSAGE_INFO che descrive gli interrupt con segnalazione 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 completata correttamente.
STATUS_INVALID_PARAMETER
Il dispositivo non usa MSI-X o i parametri TableEntry o MessageNumber non corrispondono alle risorse di interrupt assegnate al dispositivo.

Osservazioni

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

Fabbisogno

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

Vedere anche

IO_INTERRUPT_MESSAGE_INFO

IoConnectInterruptEx

PCI_MSIX_TABLE_CONFIG_INTERFACE