Macro NdisMResetComplete (NDIS 6.x)
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) |