NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX 结构 (ndis.h)

项目
08/07/2023

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_NBL_MEDIA_SPECIFIC_INFORMATION_EX) 的NDIS_OBJECT_HEADER结构。驱动程序将 Header 指定的结构的 Type 成员设置为NDIS_OBJECT_TYPE_DEFAULT，Revision 成员设置为NDIS_NBL_MEDIA_SPECIFIC_INFO_REVISION_1，将 Size 成员设置为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结构链接列表中指定，每个结构都包含驱动程序分配的数据和驱动程序定义的数据。

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

如果协议驱动程序分配了 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 宏。