Partager via


NdisFRestartFilter, fonction (ndis.h)

Un pilote de filtre appelle la fonction NdisFRestartFilter pour demander à NDIS de lancer une opération de redémarrage pour un module de filtre.

Syntaxe

NDIS_STATUS NdisFRestartFilter(
  [in] NDIS_HANDLE NdisFilterHandle
);

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.

Valeur de retour

NdisFRestartFilter retourne l’une des valeurs d’état suivantes :

Retourner le code Description
NDIS_STATUS_SUCCESS

NdisFRestartFilter retourne NDIS_STATUS_SUCCESS si elle a démarré l’opération de redémarrage.

NDIS_STATUS_RESOURCES

NdisFRestartFilter a échoué en raison de ressources insuffisantes.

NDIS_STATUS_FAILURE

NdisFRestartFilter retourne NDIS_STATUS_FAILURE si aucune des valeurs précédentes ne s’applique.

Remarques

Le pilote de filtre peut modifier les attributs du module de filtre au moment de l’exécution en appelant la fonction NdisFRestartFilter. NdisFRestartFilter planifie une pause, puis une opération de redémarrage pour le module de filtre spécifié.

Avant que NDIS redémarre le module de filtre, il appelle la fonction FilterSetModuleOptions pour le module de filtre. À partir de sa fonction FilterSetModuleOptions, le pilote de filtre peut modifier les gestionnaires de données pour ce module de filtre en appelant la fonction NdisSetOptionalHandlers et en spécifiant un nouvel ensemble de gestionnaires.

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 <= DISPATCH_LEVEL
règles de conformité DDI Irql_Filter_Driver_Function(ndis)

Voir aussi

FilterAttach

FilterSetModuleOptions

NdisSetOptionalHandlers