NdisFSetAttributes, fonction (ndis.h)

  • Article

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
NDIS_STATUS_SUCCESS
 NdisFSetAttributes retourne NDIS_STATUS_SUCCESS s’il définit les attributs du pilote de filtre.
NDIS_STATUS_RESOURCES
 NdisFSetAttributes a échoué en raison de ressources insuffisantes.
NDIS_STATUS_FAILURE
 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)

Voir aussi

FilterAttach

FilterSendNetBufferLists

NDIS_FILTER_ATTRIBUTES