Fonction NdisMRestartComplete (ndis.h)

Article
02/26/2024

Un pilote miniport doit appeler la fonction NdisMRestartComplete pour effectuer une opération de redémarrage si le pilote a retourné NDIS_STATUS_PENDING à partir de sa fonction MiniportRestart .

Syntaxe

void NdisMRestartComplete(
  [in] IN NDIS_HANDLE MiniportAdapterHandle,
  [in] IN NDIS_STATUS Status
);

Paramètres

[in] MiniportAdapterHandle

Handle de l’adaptateur miniport que NDIS a transmis au paramètre MiniportAdapterHandle du Fonction MiniportInitializeEx .

[in] Status

Dernière status de l’opération de redémarrage. Les valeurs status suivantes sont prises en charge :

NDIS_STATUS_SUCCESS

Le pilote a correctement redémarré le flux de données réseau via l’adaptateur miniport.

NDIS_STATUS_RESOURCES

Le redémarrage a échoué en raison de ressources insuffisantes.

NDIS_STATUS_FAILURE

Le pilote indique NDIS_STATUS_FAILURE si aucune des valeurs précédentes ne s’applique. Le pilote doit appeler la fonction NdisWriteErrorLogEntry avec des paramètres qui spécifient la raison de l’échec.

Valeur de retour

None

Remarques

L’adaptateur miniport spécifié dans MiniportAdapterHandle passe à l’état Restarting lorsque NDIS appelle la fonction MiniportRestart .

Une fois que le pilote miniport a correctement redémarré les opérations d’envoi et de réception pour l’adaptateur miniport, le pilote doit terminer l’opération de redémarrage en attente. L’opération de redémarrage en attente est terminée après que le pilote a appelé NdisMRestartComplete. L’adaptateur miniport est à l’état En cours d’exécution une fois l’opération de redémarrage terminée.

Un pilote miniport peut reprendre en indiquant les paquets reçus immédiatement après que NDIS a appelé MiniportRestart et avant que le pilote appelle NdisMRestartComplete. Le pilote doit être prêt à accepter les demandes d’envoi une fois la demande de redémarrage terminée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.0 et versions ultérieures.
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)