struktur NDIS_NET_BUFFER_LIST_8021Q_INFO (ndis/nbl8021q.h)

Struktur NDIS_NET_BUFFER_LIST_8021Q_INFO menentukan informasi 802.1Q yang terkait dengan struktur NET_BUFFER_LIST .

Sintaks

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;

Anggota

TagHeader

Anggota dalam serikat yang terkandung dalam NDIS_NET_BUFFER_LIST_8021Q_INFO. 802.3 Driver miniport Ethernet menggunakan TagHeader untuk mengakses informasi 802.1Q. TagHeader adalah bidang bit dengan anggota berikut:

TagHeader.UserPriority

Menentukan informasi prioritas 802.1p yang digunakan untuk menetapkan prioritas paket di jaringan 802 media bersama. Bit dalam anggota ini menentukan nilai prioritas 802.1p.

TagHeader.CanonicalFormatId

Anggota ini harus diatur ke nol, yang menunjukkan bahwa semua informasi alamat MAC yang ada dalam paket dalam format kanonis (yaitu, bentuk paling sederhana).

TagHeader.VlanId

Mengidentifikasi VLAN tempat paket berada. Paket keluar ditandai dengan pengidentifikasi VLAN.

TagHeader.Reserved

Anggota ini dicadangkan dan harus diatur ke nol.

WLanTagHeader

Anggota dalam serikat yang terkandung dalam NDIS_NET_BUFFER_LIST_8021Q_INFO. Driver miniport native 802.11 menggunakan WLanTagHeader untuk mengakses informasi 802.1Q. WLanTagHeader adalah bidang bit dengan anggota berikut:

WLanTagHeader.UserPriority

Menentukan informasi prioritas 802.1p yang digunakan untuk menetapkan prioritas paket di jaringan 802 media bersama. Bit dalam anggota ini menentukan nilai prioritas 802.1p.

WLanTagHeader.CanonicalFormatId

Anggota ini harus diatur ke nol, yang menunjukkan bahwa semua informasi alamat MAC yang ada dalam paket dalam format kanonis (yaitu, bentuk paling sederhana).

WLanTagHeader.VlanId

Mengidentifikasi VLAN tempat paket berada. Paket keluar ditandai dengan pengidentifikasi VLAN.

WLanTagHeader.WMMInfo

Nilai bilangan bulat multimedia nirkabel (WMM) yang sama dengan bidang pengidentifikasi lalu lintas (TID) yang muncul dalam bingkai tertentu yang digunakan untuk mengirimkan dan mengontrol pengiriman data Quality of Service (QoS) 802.1Q. Nilai 0 sampai 7 mewakili prioritas pengguna QoS (UPs) untuk unit data layanan MAC (MSDUs). Nilai 8 hingga 15 dicadangkan. Oleh karena itu, bit tertinggi di WMMInfo harus nol.

Catatan Spesifikasi lalu lintas (TSPEC) dan klasifikasi lalu lintas (TCLAS) tidak didukung.

 

WLanTagHeader.Reserved

Anggota ini dicadangkan dan harus diatur ke nol.

Value

Anggota dalam serikat yang terkandung dalam NDIS_NET_BUFFER_LIST_8021Q_INFO. Nilai berisi nilai penunjuk yang kompatibel dengan jenis dengan anggota NetBufferListInfo dalam struktur NET_BUFFER_LIST .

Keterangan

Untuk mengambil atau menyisipkan informasi 802.1Q yang terkait dengan struktur NET_BUFFER_LIST , driver NDIS memanggil makro NET_BUFFER_LIST_INFO dan menentukan jenis informasi Ieee8021QNetBufferListInfo .

Makro NET_BUFFER_LIST_INFO mengembalikan penunjuk yang ditentukan dalam anggota Nilai dari struktur NDIS_NET_BUFFER_LIST_8021Q_INFO. Driver NDIS dapat menggunakan anggota TagHeader atau WLanTagHeader dari serikat pekerja untuk mengakses jenis informasi tertentu, seperti prioritas 802.1p dan informasi pengidentifikasi VLAN. Anggota WLanTagHeader menyediakan akses ke informasi multimedia nirkabel (WMM) selain informasi yang tersedia melalui anggota TagHeader .

Driver Miniport yang mendukung tag 802.1Q dalam perangkat keras harus menggunakan struktur NDIS_NET_BUFFER_LIST_8021Q_INFO untuk operasi transmisi dan penerimaan:

• Untuk operasi transmisi, driver miniport harus memeriksa data OOB NDIS_NET_BUFFER_LIST_8021Q_INFO dalam struktur NET_BUFFER_LIST . Driver miniport harus memastikan bahwa perangkat keras membuat tag 802.1Q dari spesifikasi NDIS_NET_BUFFER_LIST_8021Q_INFO dan memasukkannya ke dalam bingkai Ethernet.
• Untuk operasi penerimaan, driver miniport harus menghapus tag 802.1Q dari bingkai Ethernet dan memetakan informasi tag 802.1Q ke dalam data OOB NDIS_NET_BUFFER_LIST_8021Q_INFO dalam struktur NET_BUFFER_LIST sebelum menunjukkan data ke NDIS dengan Fungsi NdisMIndicateReceiveNetBufferLists .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.0 dan yang lebih baru.
Header	ndis/nbl8021q.h (termasuk ndis.h)

Lihat juga

NET_BUFFER_LIST

NET_BUFFER_LIST_INFO

NdisMIndicateReceiveNetBufferLists