NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX结构（ndis.h）

项目
02/07/2025

NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX 结构定义与 NET_BUFFER_LIST 结构关联的特定于媒体的信息。

语法

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;

成员

Header

结构的 NDIS_OBJECT_HEADER 结构（NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX）。驱动程序将类型成员设置为标头指定为NDIS_OBJECT_TYPE_DEFAULT、修订成员设置为NDIS_NBL_MEDIA_SPECIFIC_INFO_REVISION_1，并将大小成员设置为NDIS_SIZEOF_NBL_MEDIA_SPECIFIC_INFO_REVISION_1。

NextEntry

指向NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX结构链接列表中的下一个NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX结构的指针。如果这是列表中的最后一个结构，则指针 NULL。驱动程序必须使用 NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX， NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX和 NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX 宏来作此列表。

Tag

一个唯一值（由Microsoft分配），用于标识特定于媒体的信息的类型。此成员保留供系统使用。

可以在将来的系统版本中为需要特定于特定媒体类型的其他 OOB 数据的新媒体类型分配新标记。

Data

指向包含媒体特定信息的缓冲区的指针。

言论

NDIS 6.20 及更高版本的驱动程序应使用NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX结构来指定特定于媒体的信息。 NDIS 驱动程序堆栈中的任何驱动程序都可以分配和管理特定于媒体的信息。特定于媒体的信息在以 NULL 结尾的链接列表中指定NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX结构，每个结构都包含驱动程序分配的数据和驱动程序定义的数据。

列表中的结构包含与 NET_BUFFER_LIST 结构关联的 NET_BUFFER 结构的任何特定于媒体的带外（OOB）数据。

如果协议驱动程序分配了 OOB 数据，则会为发送作配置数据。如果微型端口驱动程序分配了数据，则会为接收指示配置数据。

若要获取链接列表中的第一个元素，NDIS 驱动程序调用 NET_BUFFER_LIST_INFO 宏，并指定 MediaSpecificInformationEx 信息类型。

若要在链接列表中添加、获取和删除NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX结构，请使用 NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX， NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX和 NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX 宏。