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 affectés par l’appareil.
Syntaxe
NDIS_STATUS NdisMConfigMSIXTableEntry(
[in] NDIS_HANDLE NdisMiniportHandle,
[in] PNDIS_MSIX_CONFIG_PARAMETERS MSIXConfigParameters
);
Paramètres
[in] NdisMiniportHandle
Handle d’adaptateur miniport NDIS fourni au NDIS 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 de retour
NdisMConfigMSIXTableEntry retourne un code d’échec approprié du pilote de bus PCI sous-jacent ou l’une des valeurs d’état suivantes :
| Retourner le code | Description |
|---|---|
|
L’entrée de table MSI-X a été reconfigurée avec succès. |
|
NdisMConfigMSIXTableEntry a échoué, car un ou plusieurs membres dans le NDIS_MSIX_CONFIG_PARAMETERS structure n’était pas valide. |
Remarques
Les pilotes miniport NDIS qui prennent en charge MSI-X appeler la fonction NdisMConfigMSIXTableEntry pour masquer, masquer ou mapper des entrées de table MSI-X aux messages MSI-X affectés par l’appareil. Les pilotes miniports 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 requête GUID_MSIX_TABLE_CONFIG_INTERFACE. Les pilotes Miniport peuvent appeler NdisMConfigMSIXTableEntry après l’appel de la fonction MiniportInitializeEx et avant le retour du pilote à partir de la fonction MiniportHaltEx.
Le pilote miniport peut définir l’affinité processeur de MSI-X ressources d’interruption afin que l’appareil ait au moins un message MSI-X pour chaque processeur RSS. Notez que le pilote de bus PCI mappe initialement les entrées de table n MSI-X (où n correspond au nombre d’entrées de table MSI-X que la carte réseau avait signalées au bus) aux premiers messages n MSI-X dans les ressources modifiées. Après que NDIS appelle 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 qui a déjà l’affinité définie sur le processeur souhaité.
Pour l’opération de NdisMSIXTableConfigSetTableEntry, les appelants de NdisMConfigMSIXTableEntry doivent s’exécuter sur IRQL <= DISPATCH_LEVEL.
Pour les opérations NdisMSIXTableConfigMaskTableEntry ou NdisMSIXTableConfigUnmaskTableEntry, les appelants de NdisMConfigMSIXTableEntry peuvent s’exécuter à n’importe quel runtime IRQL.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge dans NDIS 6.1 et versions ultérieures. |
| plateforme cible | Universel |
| d’en-tête | ndis.h (include Ndis.h) |
| bibliothèque | Ndis.lib |
| IRQL | Voir la section Remarques |