Macro NdisMResetComplete (NDIS 6.x)
La fonction NdisMResetComplete retourne l’état final d’une demande de réinitialisation pour laquelle le pilote miniport a précédemment retourné NDIS_STATUS_PENDING.
Syntaxe
void NdisMResetComplete(
NDIS_HANDLE MiniportAdapterHandle,
NDIS_STATUS Status,
BOOLEAN AddressingReset
);
Paramètres
MiniportAdapterHandle
Handle de l’adaptateur miniport que NDIS a passé initialement à la fonction MiniportInitializeEx.
Status
État final de l’opération de réinitialisation juste terminé. Les valeurs de retour sont identiques à 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 des tâches. Dans ce cas, le pilote miniport est chargé de restaurer le reste des paramètres de configuration de la carte d’interface réseau référencée par MiniportAdapterHandle.
Si AddressingReset est FALSE, le pilote miniport est chargé de restaurer tous les paramètres de configuration de la carte réseau.
Pour plus d’informations, consultez de réinitialisation matérielle .
Valeur de retour
Aucun
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 lorsqu’une réinitialisation réversible est émise. Le pilote d’une telle carte réseau définit AddressingReset sur TRUE lorsqu’elle appelle NdisMResetComplete, ce qui entraîne l’appel de NDIS à son MiniportOidRequest fonction pour restaurer l’état d’adressage. Pour plus d’informations, consultez de réinitialisation matérielle .
Un pilote miniport doit libérer tout verrou de rotation qu’il contient 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista et versions ultérieures |
| d’en-tête | ndis.h |
| IRQL | <= DISPATCH_LEVEL |
| règles de conformité DDI | Irql_Miniport_Driver_Function(ndis) |