NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX structure (ndis.h)
The NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX structure defines media-specific information that is associated with a NET_BUFFER_LIST structure.
Syntax
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;
Members
Header
The NDIS_OBJECT_HEADER structure for the structure (NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX). The driver sets the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_DEFAULT, the Revision member to NDIS_NBL_MEDIA_SPECIFIC_INFO_REVISION_1, and the Size member to NDIS_SIZEOF_NBL_MEDIA_SPECIFIC_INFO_REVISION_1.
NextEntry
A pointer to the next NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX structure in a linked list of NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX structures. If this is the last structure in the list, the pointer is NULL. Drivers must use the NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX, NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX, and NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX macros to manipulate this list.
Tag
A unique value (assigned by Microsoft) that identifies the type of media-specific information. This member is reserved for system use.
New tags can be assigned in future system releases for new media types that require additional OOB data specific to a particular media type.
Data
A pointer to a buffer that contains the media-specific information.
Remarks
NDIS 6.20 and later drivers should use the NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX structure to specify media-specific information. Any driver in an NDIS driver stack can allocate and manage media-specific information. The media-specific information is specified in a NULL-terminated linked list of NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX structures, and each structure contains driver-allocated and driver-defined data.
Structures in the list contain any media-specific out-of-band (OOB) data that accompanies the NET_BUFFER structures that are associated with a NET_BUFFER_LIST structure.
If a protocol driver allocated the OOB data, it configured the data for a send operation. If a miniport driver allocated the data, it configured the data for a receive indication.
To get the first element in the linked list, an NDIS driver calls the NET_BUFFER_LIST_INFO macro and specifies the MediaSpecificInformationEx information type.
To add, get, and remove NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX structures in the linked list, use the NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX, NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX, and NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX macros.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Supported in NDIS 6.20 and later. |
| Header | ndis.h (include Ndis.h) |
See also
NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EXNDIS_NBL_MEDIA_SPECIFIC_INFORMATION
NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX