NDIS_NET_BUFFER_LIST_8021Q_INFO Struktur (ndis/nbl8021q.h)

Artikel
02/07/2025

Die NDIS_NET_BUFFER_LIST_8021Q_INFO-Struktur gibt 802.1Q-Informationen an, die einer NET_BUFFER_LIST Struktur zugeordnet sind.

Syntax

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;

Angehörige

TagHeader

Ein Mitglied in der Gewerkschaft, das in NDIS_NET_BUFFER_LIST_8021Q_INFO enthalten ist. 802.3 Ethernet-Miniporttreiber verwenden TagHeader- für den Zugriff auf 802.1Q-Informationen. TagHeader- ist ein Bitfeld mit den folgenden Elementen:

TagHeader.UserPriority

Gibt 802.1p-Prioritätsinformationen an, die zum Einrichten der Paketpriorität in Freigegebenen Medien 802-Netzwerken verwendet werden. Die Bits in diesem Member geben einen 802.1p-Prioritätswert an.

TagHeader.CanonicalFormatId

Dieses Element sollte auf Null festgelegt werden, was angibt, dass alle MAC-Adressinformationen, die in einem Paket vorhanden sind, im kanonischen Format (d. s. einfachste Form) vorhanden sind.

TagHeader.VlanId

Identifiziert das VLAN, zu dem ein Paket gehört. Ausgehende Pakete werden mit dem VLAN-Bezeichner gekennzeichnet.

TagHeader.Reserved

Dieses Element ist reserviert und sollte auf Null festgelegt werden.

WLanTagHeader

Ein Mitglied in der Gewerkschaft, das in NDIS_NET_BUFFER_LIST_8021Q_INFO enthalten ist. Native 802.11-Miniporttreiber verwenden WLanTagHeader- für den Zugriff auf 802.1Q-Informationen. WLanTagHeader- ist ein Bitfeld mit den folgenden Elementen:

WLanTagHeader.UserPriority

WLanTagHeader.CanonicalFormatId

Dieses Element sollte auf Null festgelegt werden, was angibt, dass alle MAC-Adressinformationen, die in einem Paket vorhanden sind, im kanonischen Format (d. s. einfachste Form) vorhanden sind.

WLanTagHeader.VlanId

Identifiziert das VLAN, zu dem ein Paket gehört. Ausgehende Pakete werden mit dem VLAN-Bezeichner gekennzeichnet.

WLanTagHeader.WMMInfo

Ein ganzzahliger Wert (Wireless Multimedia Multimedia, WMM), der mit den TID-Feldern (Traffic Identifier) übereinstimmt, die in bestimmten Frames angezeigt werden, die verwendet werden, um die Übermittlung von QoS-Daten (802.1Q Quality of Service) zu steuern. Die Werte 0 bis 7 stellen QoS-Benutzerprioritäten (UPs) für die MAC-Dienstdateneinheiten (MSDUs) dar. Die Werte 8 bis 15 sind reserviert. Daher muss das höchste Bit in WMMInfo- null sein.

Hinweis Datenverkehrsspezifikation (TSPEC) und die Datenverkehrsklassifizierung (TCLAS) werden nicht unterstützt.

WLanTagHeader.Reserved

Dieses Element ist reserviert und sollte auf Null festgelegt werden.

Value

Ein Mitglied in der Gewerkschaft, das in NDIS_NET_BUFFER_LIST_8021Q_INFO enthalten ist. Value enthält einen Zeigerwert, der typkompatibel mit dem NetBufferListInfo Member in der NET_BUFFER_LIST-Struktur ist.

Bemerkungen

Zum Abrufen oder Einfügen von 802.1Q-Informationen, die einer NET_BUFFER_LIST Struktur zugeordnet sind, ruft ein NDIS-Treiber das NET_BUFFER_LIST_INFO Makro auf und gibt den Ieee8021QNetBufferListInfo Informationstyp an.

Das NET_BUFFER_LIST_INFO Makro gibt den Zeiger zurück, der im Value Member der NDIS_NET_BUFFER_LIST_8021Q_INFO-Struktur angegeben ist. Der NDIS-Treiber kann den TagHeader- oder WLanTagHeader- Mitglied der Union verwenden, um auf bestimmte Informationstypen zuzugreifen, z. B. 802.1p-Prioritäts- und VLAN-ID-Informationen. Das WLanTagHeader Mitglied bietet zusätzlich zu den Informationen, die über das TagHeader Mitglied verfügbar sind, Zugriff auf die Drahtlose Multimedia-Informationen (WMM).

Miniport-Treiber, die das 802.1Q-Tag in der Hardware unterstützen, müssen die NDIS_NET_BUFFER_LIST_8021Q_INFO Struktur für Übertragungs- und Empfangsvorgänge verwenden:

Für Übertragungsvorgänge muss der Miniporttreiber in der NET_BUFFER_LIST-Struktur nach NDIS_NET_BUFFER_LIST_8021Q_INFO OOB-Daten suchen. Der Miniporttreiber muss sicherstellen, dass die Hardware das 802.1Q-Tag aus den NDIS_NET_BUFFER_LIST_8021Q_INFO Spezifikationen erstellt und in den Ethernet-Frame einfügt.
Für Empfangsvorgänge muss der Miniporttreiber das 802.1Q-Tag aus dem Ethernet-Frame entfernen und die 802.1Q-Taginformationen in den NDIS_NET_BUFFER_LIST_8021Q_INFO OOB-Daten in der NET_BUFFER_LIST Struktur zuordnen, bevor die Daten mit dem NDIS mit dem NDIS angegeben werden. NdisMIndicateReceiveNetBufferLists Funktion.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDIS 6.0 und höher.
Header-	ndis/nbl8021q.h (include ndis.h)

Siehe auch

NET_BUFFER_LIST

NET_BUFFER_LIST_INFO

NdisMIndicateReceiveNetBufferLists

Freigeben über