PCI_MSIX_SET_ENTRY fonction de rappel (wdm.h)
La routine SetTableEntry définit l’ID de message d’une entrée de table dans la table d’interruption matérielle MSI-X.
Syntaxe
PCI_MSIX_SET_ENTRY PciMsixSetEntry;
NTSTATUS PciMsixSetEntry(
[in] PVOID Context,
[in] ULONG TableEntry,
[in] ULONG MessageNumber
)
{...}
Paramètres
[in] Context
Pointeur vers des informations de contexte spécifiques à l’interface. L’appelant transmet la valeur transmise en tant que membre Context de la structure PCI_MSIX_TABLE_CONFIG_INTERFACE pour l’interface.
[in] TableEntry
Index de l’entrée de table dans la table d’interruption matérielle MSI-X.
[in] MessageNumber
ID de message de l’interruption. Cette valeur est également l’index de l’entrée de l’interruption dans l'MessageInfo membre de la structure IO_INTERRUPT_MESSAGE_INFO qui décrit les interruptions signalées par le message du pilote. La fonction IoConnectInterruptEx fournit un pointeur vers cette structure.
Valeur de retour
La routine SetTableEntry peut retourner l’une des valeurs NTSTATUS suivantes :
| Retourner le code | Description |
|---|---|
|
L’opération s’est terminée avec succès. |
|
L’appareil n’utilise pas MSI-X ou les paramètres TableEntry ou MessageNumber ne correspondent pas aux ressources d’interruption affectées à l’appareil. |
Remarques
Par défaut, le système d’exploitation affecte l’index de l’entrée de table en tant qu’ID de message pour l’interruption. S’il existe plus d’entrées de table que de messages, le système définit les entrées de table restantes pour qu’elles correspondent au message zéro. Le pilote peut utiliser la routine SetTableEntry pour affecter un autre ID de message.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista avec Service Pack 1 (SP1), Windows Server 2008 et versions ultérieures du système d’exploitation Windows. |
| plateforme cible | Bureau |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | <= DIRQL |