Macro NdisMResetComplete (ndis.h)

  • Article

Notes

Pour NDIS 6.x (Windows Vista et versions ultérieures), utilisez la fonction NdisMResetComplete (NDIS 6.x) à la place.

La fonction NdisMResetComplete retourne la dernière status d’une demande de réinitialisation pour laquelle le pilote miniport a précédemment renvoyé NDIS_STATUS_PENDING.

Syntaxe

void NdisMResetComplete(
   _M,
   _S,
   _A
);

Paramètres

_M

Poignée de l’adaptateur miniport que NDIS a passée à l’origine à la fonction MiniportInitializeEx .

_S

Dernière status de l’opération de réinitialisation qui vient d’être terminée. Les valeurs de retour sont les mêmes que celles répertoriées pour la fonction de rappel MINIPORT_RESET.

_A

Valeur booléenne true si NDIS est responsable de la restauration des paramètres des adresses de multidiffusion, des filtres de paquets et des informations de déchargement de tâche. Dans ce cas, le pilote miniport est chargé de restaurer le reste des paramètres de configuration de l’interface réseau carte (NIC) référencée par MiniportAdapterHandle .

Si AddressingReset a la valeur FALSE, le pilote miniport est chargé de restaurer tous les paramètres de configuration de la carte réseau.

Pour plus d’informations, consultez Réinitialisation matérielle.

Valeur de retour

None

Remarques

Si la fonction MiniportResetEx retourne NDIS_STATUS_PENDING, le pilote miniport doit appeler NdisMResetComplete lorsqu’il termine l’opération de réinitialisation.

Les pilotes de protocole ne peuvent pas lancer une opération de réinitialisation dans NDIS 6.0 et versions ultérieures.

Certaines cartes réseau perdent toutes les informations d’adresse de multidiffusion, de filtre de paquets ou d’adresse fonctionnelle lors de l’émission d’une réinitialisation réversible. Le pilote d’une telle carte réseau définit AddressingReset sur TRUE quand il appelle NdisMResetComplete, ce qui oblige NDIS à appeler sa fonction MiniportOidRequest pour restaurer l’état d’adressage. Pour plus d’informations, consultez Réinitialisation matérielle.

Un pilote miniport doit libérer tout verrou de rotation qu’il tient avant d’appeler NdisMResetComplete.

Dans NDIS 6.0 et versions ultérieures, les appelants de NdisMResetComplete doivent s’exécuter à IRQL <= DISPATCH_LEVEL. Sinon, les appelants de NdisMResetComplete doivent s’exécuter à IRQL = DISPATCH_LEVEL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge dans NDIS 5.1 et NDIS 6.0 et versions ultérieures. Pour les pilotes NDIS 5.1, consultez NdisMResetComplete (NDIS 5.1).
Plateforme cible Universal
En-tête ndis.h (inclure Ndis.h)
Bibliothèque Ndis.lib
IRQL DISPATCH_LEVEL
Règles de conformité DDI Irql_Miniport_Driver_Function(ndis)

Voir aussi

MiniportInitializeEx

MiniportOidRequest

MiniportResetEx

Fonction NdisMResetComplete (NDIS 6.x)