Partager via


NdisFRestartComplete, fonction (ndis.h)

Un pilote de filtre doit appeler la fonction NdisFRestartComplete pour effectuer 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

État final de l’opération de redémarrage. Les valeurs d’état suivantes sont prises en charge :

NDIS_STATUS_SUCCESS

Le pilote a 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

Aucun

Remarques

NDIS appelle la fonction FilterRestart d’un pilote de filtre pour lancer une demande de redémarrage pour le module de filtre. Le module de filtre reste dans 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 une fois que le pilote appelle 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 en indiquant les 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.

Exigences

Exigence Valeur
client minimum pris en charge Prise en charge dans NDIS 6.0 et versions ultérieures.
plateforme cible Bureau
d’en-tête ndis.h (include Ndis.h)
bibliothèque Ndis.lib
IRQL PASSIVE_LEVEL
règles de conformité DDI Irql_Filter_Driver_Function(ndis)

Voir aussi

FilterAttach

filterRestart

NdisWriteEventLogEntry