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 par l’appelant pour ce module de filtre.

[in] FilterAttributes

Pointeur vers un pilote de filtre alloué structure NDIS_FILTER_ATTRIBUTES.

Valeur de retour

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

Retourner le code	Description
NDIS_STATUS_SUCCESS	NdisFSetAttributes retourne NDIS_STATUS_SUCCESS si elle 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 passé à FilterAttach au 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.

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

Voir aussi

FilterAttach

FilterSendNetBufferLists

NDIS_FILTER_ATTRIBUTES