NDIS_OPEN_PARAMETERS struttura (ndis.h)

Articolo
05/23/2024

La struttura NDIS_OPEN_PARAMETERS definisce i parametri aperti quando un driver di protocollo chiama la funzione NdisOpenAdapterEx .

Sintassi

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;

Members

Header

Struttura NDIS_OBJECT_HEADER per la struttura NDIS_OPEN_PARAMETERS. Impostare il membro Type della struttura che Header specifica su NDIS_OBJECT_TYPE_OPEN_PARAMETERS, il membro Revision su NDIS_OPEN_PARAMETERS_REVISION_1 e il membro Size sul NDIS_SIZEOF_OPEN_PARAMETERS_REVISION_1.

AdapterName

Stringa Unicode contenente il nome dell'adattatore miniport passato a ProtocolBindAdapterEx nel membro AdapterName del parametro BindParameters . Questo nome può identificare un adattatore fisico, ovvero una scheda di interfaccia di rete, o una scheda virtuale associata a un driver intermedio.

MediumArray

Puntatore a una matrice di valori NdisMediumXxx che elenca i tipi di supporti che il chiamante può supportare. Questo elenco è un subset dei tipi di NDIS_MEDIUM .

MediumArraySize

Numero di elementi nel membro MediumArray .

SelectedMediumIndex

Puntatore a una variabile UINT fornita dal driver che contiene un indice nella matrice MediumArray . NDIS scrive questo indice che identifica il tipo di supporto usato dal driver sottostante.

FrameTypeArray

Puntatore a una matrice di valori NET_FRAME_TYPE, specificando i tipi di frame che si desidera che il driver del protocollo riceva. Il tipo di frame è un valore USHORT che segue l'indirizzo MAC di destinazione e origine in frame Ethernet. In presenza di tag VLAN, questo valore segue la destinazione, l'indirizzo MAC di origine e il tag VLAN. NET_FRAME_TYPE è definito come segue:

typedef USHORT  NET_FRAME_TYPE;
typedef NET_FRAME_TYPE *PNET_FRAME_TYPE;

Nota NDIS usa i valori del tipo di frame forniti dal driver del protocollo in questa matrice come hint per ottimizzare le indicazioni di ricezione inviate al driver del protocollo. NDIS non garantisce che un driver di protocollo riceva solo pacchetti con tipi di frame che corrispondono ai tipi nella matrice.

FrameTypeArraySize

Numero di elementi nel membro FrameTypeArray . Questo numero deve essere uguale o minore di NDIS_MAX_FRAME_TYPES_PER_OPEN.