NdisMSetMiniportAttributes, fonction (ndis.h)

Article
08/07/2023

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

Syntaxe

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

Paramètres

NdisMiniportHandle

La poignée de l’adaptateur miniport que NDIS a passée 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 le pilote. La structure définit les attributs de l’adaptateur miniport instance spécifié par MiniportAdapterHandle.

Valeur retournée

NdisMSetMiniportAttributes retourne l’une des valeurs status suivantes :

Code de retour	Description
NDIS_STATUS_SUCCESS	NdisMSetMiniportAttributes a correctement inscrit les attributs de l’adaptateur miniport.
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 sur 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.

The NDIS_MINIPORT_ADAPTER_ATTRIBUTES union est un espace réservé pour différentes structures d’attributs. Un pilote miniport appelle NdisMSetMiniportAttributes plusieurs fois avec différentes structures d’attributs. Un pilote miniport doit fournir un initialisé NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES structure de MiniportInitializeEx. Le pilote miniport doit fournir ces attributs d’inscription avant d’appeler toute autre fonction NdisXxx qui dépend de ces attributs ou qui demande 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 comme 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans NDIS 6.0 et versions ultérieures.
Plateforme cible	Universal
En-tête	ndis.h (inclure Ndis.h)
Bibliothèque	Ndis.lib
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	Irql_Miniport_Driver_Function(ndis),NdisMRegisterIoPortRange(ndis)