NdisFSetAttributes, fonction (ndis.h)
Un pilote de filtre appelle la fonction NdisFSetAttributes pour spécifier une zone de contexte de module de filtre.
Syntaxe
NDIS_STATUS NdisFSetAttributes(
[in] NDIS_HANDLE NdisFilterHandle,
[in] __drv_aliasesMem NDIS_HANDLE FilterModuleContext,
[in] PNDIS_FILTER_ATTRIBUTES FilterAttributes
);
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] FilterModuleContext
Zone de contexte allouée à l’appelant pour ce module de filtre.
[in] FilterAttributes
Pointeur vers un pilote de filtre alloué NDIS_FILTER_ATTRIBUTES structure.
Valeur retournée
NdisFSetAttributes retourne l’une des valeurs status suivantes :
| Code de retour | Description |
|---|---|
|
NdisFSetAttributes retourne NDIS_STATUS_SUCCESS s’il définit les attributs du pilote de filtre. |
|
NdisFSetAttributes a échoué en raison de ressources insuffisantes. |
|
NdisFSetAttributes retourne NDIS_STATUS_FAILURE si aucune des valeurs précédentes ne s’applique. |
Remarques
Un pilote de filtre appelle NdisFSetAttributes à partir de sa fonction FilterAttach et transmet le handle que NDIS a passé à FilterAttach au niveau du paramètre NdisFilterHandle . Le paramètre FilterModuleContext de NdisFSetAttributes spécifie la zone de contexte de ce module de filtre. NDIS transmet la zone de contexte au pilote de filtre dans les appels à des fonctions telles que FilterSendNetBufferLists.
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) |