estructura NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX (ndis.h)

Artículo
08/07/2023

La estructura de NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX define información específica del medio asociada a una estructura de NET_BUFFER_LIST .

Sintaxis

typedef struct _NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX {
  NDIS_OBJECT_HEADER                             Header;
  struct _NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX *NextEntry;
  ULONG                                          Tag;
  PVOID                                          Data;
} NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX, *PNDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX;

Miembros

Header

Estructura NDIS_OBJECT_HEADER de la estructura (NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX). El controlador establece el miembro Type de la estructura que Header especifica para NDIS_OBJECT_TYPE_DEFAULT, el miembro Revision en NDIS_NBL_MEDIA_SPECIFIC_INFO_REVISION_1 y el miembro Size en NDIS_SIZEOF_NBL_MEDIA_SPECIFIC_INFO_REVISION_1.

NextEntry

Puntero a la siguiente estructura de NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX en una lista vinculada de estructuras de NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX. Si se trata de la última estructura de la lista, el puntero es NULL. Los controladores deben usar NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX, NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX y NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX macros para manipular esta lista.

Tag

Valor único (asignado por Microsoft) que identifica el tipo de información específica del medio. Este miembro está reservado para uso del sistema.

Las nuevas etiquetas se pueden asignar en futuras versiones del sistema para nuevos tipos de medios que requieren datos de OOB adicionales específicos de un tipo de medio determinado.

Data

Puntero a un búfer que contiene la información específica del medio.

Comentarios

Los controladores NDIS 6.20 y versiones posteriores deben usar la estructura NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX para especificar información específica del medio. Cualquier controlador de una pila de controladores NDIS puede asignar y administrar información específica del medio. La información específica del medio se especifica en una lista vinculada terminada en NULL de estructuras de NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX y cada estructura contiene datos asignados por controladores y definidos por controladores.

Las estructuras de la lista contienen datos específicos de medios fuera de banda (OOB) que acompañan a las estructuras de NET_BUFFER asociadas a una estructura de NET_BUFFER_LIST .

Si un controlador de protocolo asignó los datos de OOB, configuró los datos para una operación de envío. Si un controlador de minipuerto asignó los datos, configuró los datos para una indicación de recepción.

Para obtener el primer elemento de la lista vinculada, un controlador NDIS llama a la macro NET_BUFFER_LIST_INFO y especifica el tipo de información MediaSpecificInformationEx .

Para agregar, obtener y quitar NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX estructuras de la lista vinculada, use NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX, NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX y NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX macros.