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 |
---|---|
|
Operazione completata correttamente. |
|
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 |