NDIS_NBL_GET_MEDIA_SPECIFIC_INFO macro (ndis.h)

Article
02/22/2024

Important

This macro is supported in NDIS 6.0 and 6.1. For NDIS 6.20 and later, use NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX.

The NDIS_NBL_GET_MEDIA_SPECIFIC_INFO macro gets a media-specific information data structure from a linked list of such structures that are associated with a NET_BUFFER_LIST structure.

Syntax

void NDIS_NBL_GET_MEDIA_SPECIFIC_INFO(
   _NBL,
   _Tag,
   _MediaSpecificInfo
);

Parameters

_NBL

A pointer to a NET_BUFFER_LIST structure.

_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.

_MediaSpecificInfo

A pointer to an NDIS_NBL_MEDIA_SPECIFIC_INFORMATION structure.

Return value

None

Remarks

Any NDIS 6.0 or 6.1 driver can use NDIS_NBL_GET_MEDIA_SPECIFIC_INFO to get media-specific information from a NET_BUFFER_LIST structure. When this macro returns, the _MediaSpecificInfo parameter contains a pointer to the first NDIS_NBL_MEDIA_SPECIFIC_INFORMATION structure in the media-specific information list that has a Tag member matching the value specified in the _Tag parameter.

Requirements

Requirement	Value
Minimum supported client	Supported in NDIS 6.0 and 6.1. For NDIS 6.20 and later, use NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX.
Target Platform	Universal
Header	ndis.h