NdisFRestartComplete, fonction (ndis.h)

Article
02/29/2024

Un pilote de filtre doit appeler la fonction NdisFRestartComplete pour terminer une opération de redémarrage si le pilote a retourné NDIS_STATUS_PENDING à partir de sa fonction FilterRestart .

Syntaxe

void NdisFRestartComplete(
  [in] NDIS_HANDLE NdisFilterHandle,
  [in] NDIS_STATUS Status
);

Paramètres

[in] NdisFilterHandle

Handle NDIS qui identifie ce module de filtre. NDIS a passé le handle au pilote de filtre dans un appel à la fonction FilterAttach .

[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.

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 NdisWriteEventLogEntry avec les paramètres qui spécifient la raison de l’échec.

Valeur de retour

None

Remarques

NDIS appelle la fonction FilterRestart d’un pilote de filtre pour lancer une demande de redémarrage du module de filtre. Le module de filtre reste à l’état Redémarrage jusqu’à ce que l’opération de redémarrage soit terminée.

Une opération de redémarrage en attente est terminée après que le pilote a appelé la fonction NdisFRestartComplete . Le module de filtre est à l’état En cours d’exécution une fois l’opération de redémarrage terminée.

Un pilote de filtre peut reprendre l’indication des données réseau reçues immédiatement après les appels NDIS FilterRestart et avant que le pilote appelle NdisFRestartComplete. Le pilote doit être prêt à accepter les demandes d’envoi une fois l’opération 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	Desktop (Expérience utilisateur)
En-tête	ndis.h (inclure Ndis.h)
Bibliothèque	Ndis.lib
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	Irql_Filter_Driver_Function(ndis)