NdisMConfigMSIXTableEntry, fonction (ndis.h)
La fonction NdisMConfigMSIXTableEntry effectue des opérations de configuration pour les entrées de table MSI-X pour les messages MSI-X attribués par l’appareil.
Syntaxe
NDIS_STATUS NdisMConfigMSIXTableEntry(
[in] NDIS_HANDLE NdisMiniportHandle,
[in] PNDIS_MSIX_CONFIG_PARAMETERS MSIXConfigParameters
);
Paramètres
[in] NdisMiniportHandle
Une poignée d’adaptateur miniport NDIS fournie par NDIS au Fonction MiniportInitializeEx .
[in] MSIXConfigParameters
Pointeur vers un appelant alloué NDIS_MSIX_CONFIG_PARAMETERS structure qui définit l’opération de configuration demandée et spécifie les paramètres requis pour cette opération particulière.
Valeur retournée
NdisMConfigMSIXTableEntry retourne un code d’échec approprié à partir du pilote de bus PCI sous-jacent ou de l’une des valeurs status suivantes :
| Code de retour | Description |
|---|---|
|
L’entrée de table MSI-X a été reconfigurée avec succès. |
|
Échec de NdisMConfigMSIXTableEntry , car un ou plusieurs membres dans le NDIS_MSIX_CONFIG_PARAMETERS structure n’étaient pas valides. |
Remarques
Les pilotes miniport NDIS qui prennent en charge MSI-X appellent la fonction NdisMConfigMSIXTableEntry pour masquer, démasquer ou mapper les entrées de table MSI-X aux messages MSI-X attribués par l’appareil. Les pilotes miniport qui prennent en charge RSS utilisent NdisMConfigMSIXTableEntry pour modifier l’affinité processeur des entrées de table MSI-X au moment de l’exécution.
NdisMConfigMSIXTableEntry est un wrapper autour du GUID_MSIX_TABLE_CONFIG_INTERFACE requête. Les pilotes Miniport peuvent appeler NdisMConfigMSIXTableEntry après que NDIS a appelé la fonction MiniportInitializeEx et avant que le pilote ne retourne à partir de la fonction MiniportHaltEx .
Le pilote miniport peut définir l’affinité processeur des ressources d’interruption MSI-X afin que l’appareil dispose d’au moins un message MSI-X pour chaque processeur RSS. Notez que le pilote de bus PCI mappe initialement les n entrées de table MSI-X (où n est le nombre d’entrées de table MSI-X que la carte réseau avait signalées au bus) aux n premiers messages MSI-X dans les ressources modifiées. Après que NDIS a appelé MiniportInitializeEx, lorsque le pilote miniport modifie le processeur cible d’une entrée de table MSI-X particulière, le pilote appelle NdisMConfigMSIXTableEntry pour mapper cette entrée de table à un message MSI-X dont l’affinité est déjà définie sur le processeur souhaité.
Pour l’opération NdisMSIXTableConfigSetTableEntry , les appelants de NdisMConfigMSIXTableEntry doivent s’exécuter à IRQL <= DISPATCH_LEVEL.
Pour les opérations NdisMSIXTableConfigMaskTableEntry ou NdisMSIXTableConfigUnmaskTableEntry , les appelants de NdisMConfigMSIXTableEntry peuvent s’exécuter à n’importe quel IRQL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge dans NDIS 6.1 et versions ultérieures. |
| Plateforme cible | Universal |
| En-tête | ndis.h (inclure Ndis.h) |
| Bibliothèque | Ndis.lib |
| IRQL | Voir la section Remarques |