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 |
|---|---|
|
NdisFRestartFilter retourne NDIS_STATUS_SUCCESS s’il a démarré l’opération de redémarrage. |
|
Échec de NdisFRestartFilter en raison de ressources insuffisantes. |
|
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) |