NDIS_NBL_MEDIA_SPECIFIC_INFORMATION structure (ndis.h)

The NDIS_NBL_MEDIA_SPECIFIC_INFORMATION structure specifies media-specific data that is associated with a NET_BUFFER_LIST structure.

Syntax

typedef struct _NDIS_NBL_MEDIA_MEDIA_SPECIFIC_INFORMATION {
  PNDIS_NBL_MEDIA_SPECIFIC_INFORMATION NextEntry;
  ULONG                                Tag;
  UCHAR                                Data[1];
} NDIS_NBL_MEDIA_SPECIFIC_INFORMATION, *PNDIS_NBL_MEDIA_SPECIFIC_INFORMATION;

Members

NextEntry

A pointer to the next media-specific information structure in a linked list.

Tag

A unique pre-assigned value that identifies the type of the 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[1]

A variable sized UCHAR array that contains the media-specific information.

Remarks

Any driver in an NDIS driver stack can allocate and manage media-specific information. The media-specific information is in a linked list of NDIS_NBL_MEDIA_SPECIFIC_INFORMATION structures that contain 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 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 access NDIS_NBL_MEDIA_SPECIFIC_INFORMATION structures in a linked list, use the NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO, NDIS_NBL_GET_MEDIA_SPECIFIC_INFO, and NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO macros.

Requirements

Requirement Value
Minimum supported client Supported in NDIS 6.0 and 6.1. For NDIS 6.20 and later, use NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX.
Header ndis.h (include Ndis.h)

See also

NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO NDIS_NBL_GET_MEDIA_SPECIFIC_INFO

NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX

NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO

NET_BUFFER

NET_BUFFER_LIST