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 retournée

NdisFRestartFilter retourne l’une des valeurs status suivantes :

Code de retour Description
NDIS_STATUS_SUCCESS

NdisFRestartFilter retourne NDIS_STATUS_SUCCESS s’il a démarré l’opération de redémarrage.

NDIS_STATUS_RESOURCES

Échec de NdisFRestartFilter 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.

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

Voir aussi

FilterAttach

FilterSetModuleOptions

NdisSetOptionalHandlers