structure NDIS_OPEN_PARAMETERS (ndis.h)

Article
05/23/2024

La structure NDIS_OPEN_PARAMETERS définit les paramètres ouverts lorsqu’un pilote de protocole appelle la fonction NdisOpenAdapterEx .

Syntaxe

typedef struct _NDIS_OPEN_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  PNDIS_STRING       AdapterName;
  PNDIS_MEDIUM       MediumArray;
  UINT               MediumArraySize;
  PUINT              SelectedMediumIndex;
  PNET_FRAME_TYPE    FrameTypeArray;
  UINT               FrameTypeArraySize;
} NDIS_OPEN_PARAMETERS, *PNDIS_OPEN_PARAMETERS;

Membres

Header

Structure NDIS_OBJECT_HEADER de la structure NDIS_OPEN_PARAMETERS. Définissez le membre Type de la structure spécifiée par l’en-tête sur NDIS_OBJECT_TYPE_OPEN_PARAMETERS, le membre Revision sur NDIS_OPEN_PARAMETERS_REVISION_1 et le membre Size sur le NDIS_SIZEOF_OPEN_PARAMETERS_REVISION_1.

AdapterName

Chaîne Unicode qui contient le nom de l’adaptateur miniport que NDIS a transmis à ProtocolBindAdapterEx dans le membre AdapterName du paramètre BindParameters . Ce nom peut identifier une carte physique (c’est-à-dire une carte réseau) ou une carte virtuelle associée à un pilote intermédiaire.

MediumArray

Pointeur vers un tableau de valeurs NdisMediumXxx qui répertorie les types de média que l’appelant peut prendre en charge. Cette liste est un sous-ensemble des types NDIS_MEDIUM .

MediumArraySize

Nombre d’éléments dans le membre MediumArray .

SelectedMediumIndex

Pointeur vers une variable UINT fournie par le pilote qui contient un index dans le tableau MediumArray . NDIS écrit cet index qui identifie le type de média utilisé par le pilote sous-jacent.

FrameTypeArray

Pointeur vers un tableau de valeurs NET_FRAME_TYPE, spécifiant les types de trames que vous souhaitez que le pilote de protocole reçoive. Le type de trame est une valeur USHORT qui suit l’adresse MAC de destination et source dans les trames Ethernet. En présence de balises VLAN, cette valeur suit la destination, l’adresse MAC source et la balise VLAN. NET_FRAME_TYPE est défini comme suit :

typedef USHORT  NET_FRAME_TYPE;
typedef NET_FRAME_TYPE *PNET_FRAME_TYPE;

Note NDIS utilise les valeurs de type frame que le pilote de protocole fournit dans ce tableau comme indicateur pour optimiser les indications de réception que NDIS envoie au pilote de protocole. NDIS ne garantit pas qu’un pilote de protocole recevra uniquement des paquets avec des types de trames qui correspondent aux types dans le tableau.

FrameTypeArraySize

Nombre d’éléments dans le membre FrameTypeArray . Ce nombre doit être égal ou inférieur à NDIS_MAX_FRAME_TYPES_PER_OPEN.