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’interruptions matérielles 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 qui est passée 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’interruptions matérielles MSI-X.
[in] MessageNumber
ID de message pour l’interruption. Cette valeur est également l’index de l’entrée de l’interruption dans le membre MessageInfo 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 retournée
La routine SetTableEntry peut retourner l’une des valeurs NTSTATUS suivantes :
| Code de retour | 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 comme ID de message pour l’interruption. S’il y a 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 attribuer un ID de message différent.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal 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 | Desktop (Expérience utilisateur) |
| En-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | <= DIRQL |