Macro NdisMResetComplete (NDIS 6.x)

  • Article

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(
  NDIS_HANDLE MiniportAdapterHandle,
  NDIS_STATUS Status,
  BOOLEAN     AddressingReset
);

Paramètres

MiniportAdapterHandle

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

Status

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.

AddressingReset

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 Windows Vista et versions ultérieures
En-tête ndis.h
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI Irql_Miniport_Driver_Function(ndis)

Voir aussi

Macro NdisMResetComplete (NDIS 5.x)