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 |
|---|---|
|
Operazione riuscita. |
|
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 |