NDIS_NET_BUFFER_LIST_8021Q_INFO - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// nbl8021q.h
typedef struct _NDIS_NET_BUFFER_LIST_8021Q_INFO {
union {
struct {
UINT32 UserPriority : 3;
UINT32 CanonicalFormatId : 1;
UINT32 VlanId : 12;
UINT32 Reserved : 16;
} TagHeader;
struct {
UINT32 UserPriority : 3;
UINT32 CanonicalFormatId : 1;
UINT32 VlanId : 12;
UINT32 WMMInfo : 4;
UINT32 Reserved : 12;
} WLanTagHeader;
PVOID Value;
};
} NDIS_NET_BUFFER_LIST_8021Q_INFO, *PNDIS_NET_BUFFER_LIST_8021Q_INFO;
View the official Windows Driver Kit DDI referenceNo description available.
The NDIS_NET_BUFFER_LIST_8021Q_INFO structure specifies 802.1Q information that is associated with a NET_BUFFER_LIST structure.
TagHeaderA member in the union that is contained in NDIS_NET_BUFFER_LIST_8021Q_INFO. 802.3 Ethernet miniport drivers use TagHeader to access 802.1Q information. TagHeader is a bit field with the following members:
TagHeader.UserPrioritySpecifies 802.1p priority information that is used to establish packet priority in shared-media 802 networks. The bits in this member specify an 802.1p priority value.
TagHeader.CanonicalFormatIdThis member should be set to zero, which indicates that all MAC address information present in a packet is in canonical format (that is, simplest form).
TagHeader.VlanIdIdentifies the VLAN that a packet belongs to. Outgoing packets are marked with the VLAN identifier.
TagHeader.ReservedThis member is reserved and should be set to zero.
WLanTagHeaderA member in the union that is contained in NDIS_NET_BUFFER_LIST_8021Q_INFO. Native 802.11 miniport drivers use WLanTagHeader to access 802.1Q information. WLanTagHeader is a bit field with the following members:
WLanTagHeader.UserPrioritySpecifies 802.1p priority information that is used to establish packet priority in shared-media 802 networks. The bits in this member specify an 802.1p priority value.
WLanTagHeader.CanonicalFormatIdThis member should be set to zero, which indicates that all MAC address information present in a packet is in canonical format (that is, simplest form).
WLanTagHeader.VlanIdIdentifies the VLAN that a packet belongs to. Outgoing packets are marked with the VLAN identifier.
WLanTagHeader.WMMInfoA wireless multimedia (WMM) integer value that is the same as the traffic identifier (TID) fields that appear in certain frames that are used to deliver and to control the delivery of 802.1Q Quality of Service (QoS) data. The values 0 through 7 represent QoS user priorities (UPs) for the MAC service data units (MSDUs). The values 8 through 15 are reserved. Therefore, the highest bit in WMMInfo must be zero.
Note Traffic specification (TSPEC) and traffic classification (TCLAS) are not supported.
WLanTagHeader.ReservedThis member is reserved and should be set to zero.
ValueA member in the union that is contained in NDIS_NET_BUFFER_LIST_8021Q_INFO. Value contains a pointer value that is type-compatible with the NetBufferListInfo member in the NET_BUFFER_LIST structure.
To retrieve or insert 802.1Q information that is associated with a NET_BUFFER_LIST structure, an NDIS driver calls the NET_BUFFER_LIST_INFO macro and specifies the Ieee8021QNetBufferListInfo information type.
The NET_BUFFER_LIST_INFO macro returns the pointer that is specified in the Value member of the NDIS_NET_BUFFER_LIST_8021Q_INFO structure. The NDIS driver can use the TagHeader or WLanTagHeader member of the union to access specific types of information, such as 802.1p priority and VLAN identifier information. The WLanTagHeader member provides access to the wireless multimedia (WMM) information in addition to the information that is available through the TagHeader member.
Miniport drivers that support the 802.1Q tag in hardware must use the NDIS_NET_BUFFER_LIST_8021Q_INFO structure for transmit and receive operations:
NdisMIndicateReceiveNetBufferLists