NdisMSetMiniportAttributes, fonction (ndis.h)

Article
02/07/2025

Un pilote miniport doit appeler la fonction NdisMSetMiniportAttributes de sa fonction MiniportInitializeEx pour identifier une zone de contexte pour l’adaptateur miniport vers NDIS et fournir à NDIS des informations sur l’adaptateur miniport.

Syntaxe

NDIS_STATUS NdisMSetMiniportAttributes(
       NDIS_HANDLE                       NdisMiniportHandle,
  [in] PNDIS_MINIPORT_ADAPTER_ATTRIBUTES MiniportAttributes
);

Paramètres

NdisMiniportHandle

Handle de l’adaptateur miniport que NDIS a passé au paramètre MiniportAdapterHandle de MiniportInitializeEx.

[in] MiniportAttributes

Pointeur vers un NDIS_MINIPORT_ADAPTER_ATTRIBUTES union qui contient une structure d’attributs alloués par un pilote. La structure définit les attributs de l’instance de l’adaptateur miniport qui MiniportAdapterHandle spécifie.

Valeur de retour

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

Retourner le code	Description
NDIS_STATUS_SUCCESS	NdisMSetMiniportAttributes inscrit les attributs de l’adaptateur miniport avec succès.
NDIS_STATUS_BAD_VERSION	Indique que NDIS ne prend pas en charge la version spécifiée dans le membre Revision de la structure spécifiée dans le membre Header à MiniportAttributes.

Remarques

Un pilote miniport doit appeler NdisMSetMiniportAttributes à partir de sa fonction MiniportInitializeEx avant que le pilote appelle toute autre fonction NdisXxx qui dépend des informations fournies à NdisMSetMiniportAttributes.

Le NDIS_MINIPORT_ADAPTER_ATTRIBUTES union est un espace réservé pour différentes structures d’attributs. Un pilote miniport appelle NdisMSetMiniportAttributes plusieurs fois avec des structures d’attributs différentes. Un pilote miniport doit fournir un initialisé structure NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES de MiniportInitializeEx. Le pilote miniport doit fournir ces attributs d’inscription avant d’appeler d’autres Ndisxxx fonction qui dépend de ces attributs ou qui prétend des ressources matérielles.

Le pilote fournit un membre MiniportAdapterContext à NDIS dans la structure NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES. Le membre MiniportAdapterContext identifie une zone de contexte fournie par l’appelant que NDIS transmet en tant que paramètre d’entrée aux fonctions MiniportXxx du pilote. Cette zone de contexte contient des informations d’état spécifiques à l’adaptateur miniport.

Les pilotes miniport doivent définir les attributs dans le NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES structure après avoir défini les attributs d’inscription dans la structure NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES et avant de définir des attributs supplémentaires.

Un pilote miniport peut également appeler NdisMSetMiniportAttributes à partir de sa fonction MiniportAddDevice. Dans ce cas, la structure NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES est utilisée pour spécifier la zone de contexte.

Exigences

Exigence	Valeur
client minimum pris en charge	Prise en charge dans NDIS 6.0 et versions ultérieures.
plateforme cible	Universel
d’en-tête	ndis.h (include Ndis.h)
bibliothèque	Ndis.lib
IRQL	PASSIVE_LEVEL
règles de conformité DDI	Irql_Miniport_Driver_Function(ndis), NdisMRegisterIoPortRange(ndis)