estructura de NDIS_OPEN_PARAMETERS (ndis.h)

  • Artículo

La estructura NDIS_OPEN_PARAMETERS define los parámetros abiertos cuando un controlador de protocolo llama a la función NdisOpenAdapterEx .

Sintaxis

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;

Miembros

Header

Estructura NDIS_OBJECT_HEADER de la estructura NDIS_OPEN_PARAMETERS. Establezca el miembro Type de la estructura que Header especifica para NDIS_OBJECT_TYPE_OPEN_PARAMETERS, el miembro Revision en NDIS_OPEN_PARAMETERS_REVISION_1 y el miembro Size en el NDIS_SIZEOF_OPEN_PARAMETERS_REVISION_1.

AdapterName

Cadena Unicode que contiene el nombre del adaptador de minipuerto que NDIS pasó a ProtocolBindAdapterEx en el miembro AdapterName del parámetro BindParameters . Este nombre puede identificar un adaptador físico (es decir, una NIC) o un adaptador virtual asociado a un controlador intermedio.

MediumArray

Puntero a una matriz de valores NdisMediumXxx que enumera los tipos de medios que el autor de la llamada puede admitir. Esta lista es un subconjunto de los tipos de NDIS_MEDIUM .

MediumArraySize

Número de elementos del miembro MediumArray .

SelectedMediumIndex

Puntero a una variable UINT proporcionada por el controlador que contiene un índice en la matriz MediumArray . NDIS escribe este índice que identifica el tipo de medio que usa el controlador subyacente.

FrameTypeArray

Puntero a una matriz de valores de NET_FRAME_TYPE, especificando los tipos de marco que desea que reciba el controlador de protocolo. El tipo de marco es un valor de USHORT que sigue el destino y la dirección MAC de origen en fotogramas Ethernet. En presencia de etiquetas VLAN, este valor sigue el destino, la dirección MAC de origen y la etiqueta VLAN. NET_FRAME_TYPE se define de la siguiente manera:

typedef USHORT  NET_FRAME_TYPE;
typedef NET_FRAME_TYPE *PNET_FRAME_TYPE;
Nota NDIS usa los valores de tipo de marco que proporciona el controlador de protocolo en esta matriz como sugerencia para optimizar las indicaciones de recepción que NDIS envía al controlador de protocolo. NDIS no garantiza que un controlador de protocolo solo reciba paquetes con tipos de marco que coincidan con los tipos de la matriz.
 

FrameTypeArraySize

Número de elementos del miembro FrameTypeArray . Este número debe ser igual o menor que NDIS_MAX_FRAME_TYPES_PER_OPEN.

Comentarios

Un controlador de protocolo pasa una estructura de NDIS_OPEN_PARAMETERS cuando llama a la función NdisOpenAdapterEx para abrir un adaptador de minipuerto.

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con NDIS 6.0 y versiones posteriores.
Encabezado ndis.h (incluya Ndis.h)

Consulte también

NDIS_MEDIUM

NDIS_OBJECT_HEADER

NdisOpenAdapterEx

ProtocolBindAdapterEx