struktur NDIS_SWITCH_PORT_PROPERTY_VLAN (ntddndis.h)

Artikel
03/08/2023

Struktur NDIS_SWITCH_PORT_PROPERTY_VLAN menentukan properti kebijakan jaringan area lokal virtual (VLAN) untuk port sakelar yang dapat diperluas Hyper-V.

Sintaks

typedef struct _NDIS_SWITCH_PORT_PROPERTY_VLAN {
  NDIS_OBJECT_HEADER         Header;
  ULONG                      Flags;
  NDIS_SWITCH_PORT_VLAN_MODE OperationMode;
  union {
    struct {
      UINT16 AccessVlanId;
      UINT16 NativeVlanId;
      UINT64 PruneVlanIdArray[64];
      UINT64 TrunkVlanIdArray[64];
    } VlanProperties;
    struct {
      NDIS_SWITCH_PORT_PVLAN_MODE PvlanMode;
      UINT16                      PrimaryVlanId;
      union {
        UINT16 SecondaryVlanId;
        UINT64 SecondaryVlanIdArray[64];
      };
    } PvlanProperties;
  };
} NDIS_SWITCH_PORT_PROPERTY_VLAN, *PNDIS_SWITCH_PORT_PROPERTY_VLAN;

Anggota

Header

Jenis, revisi, dan ukuran struktur NDIS_SWITCH_PORT_PROPERTY_VLAN . Anggota ini diformat sebagai struktur NDIS_OBJECT_HEADER .

Anggota JenisHeader harus diatur ke NDIS_OBJECT_TYPE_DEFAULT. Untuk menentukan versi struktur NDIS_SWITCH_PORT_PROPERTY_VLAN , anggota RevisiHeader harus diatur ke nilai berikut:

NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_VLAN_REVISION_1.

Flags

Nilai ULONG yang berisi bitwise ATAU bendera. Anggota ini dicadangkan untuk NDIS.

OperationMode

Nilai enumerasi NDIS_SWITCH_PORT_VLAN_MODE yang menentukan mode operasi VLAN.

VlanProperties

Struktur yang menentukan properti VLAN dengan mode operasi NdisSwitchPortVlanModeAccess atau NdisSwitchPortVlanModeTrunk. Struktur ini berisi anggota berikut:

VlanProperties.AccessVlanId

Nilai UINT16 yang menentukan pengidentifikasi VLAN untuk port sakelar yang dapat diperluas yang beroperasi dalam mode akses VLAN.

Catatan Anggota ini hanya valid jika anggota OperationMode diatur ke NdisSwitchPortVlanModeAccess.

VlanProperties.NativeVlanId

Nilai UINT16 yang menentukan pengidentifikasi VLAN untuk port sakelar yang dapat diperluas yang beroperasi dalam mode batang VLAN.

VlanProperties.PruneVlanIdArray[64]

Array elemen UINT64 yang menentukan pengidentifikasi VLAN yang paketnya diblokir pada port sakelar yang dapat diperluas.

Array memiliki 64 elemen UINT64 yang mewakili 4096 bit berturut-turut. Setiap bit yang memiliki nilai satu menentukan pengidentifikasi VLAN yang paketnya diblokir agar tidak dikirim atau diterima pada port sakelar yang dapat diperluas. Misalnya, jika bit tiga diatur ke satu, lalu lintas paket dari pengidentifikasi VLAN tiga diblokir pada port. Demikian pula, jika bit 64 diatur ke nol, lalu lintas paket dari pengidentifikasi VLAN 64 tidak diblokir pada port.

Catatan VLANS dengan pengidentifikasi yang memetakan ke nilai bit satu selalu diblokir. Ini mengambil alih pengaturan bit yang setara untuk pengidentifikasi VLAN di anggota TrunkVlanIdArray .

VlanProperties.TrunkVlanIdArray[64]

Array elemen UINT64 yang menentukan pengidentifikasi VLAN yang paketnya diizinkan pada port sakelar yang dapat diperluas.

Array memiliki 64 elemen UINT64 yang mewakili 4096 bit berturut-turut. Setiap bit yang memiliki nilai satu menentukan pengidentifikasi VLAN yang paketnya diizinkan untuk dikirim atau diterima pada port sakelar yang dapat diperluas. Misalnya, jika bit dua diatur ke satu, lalu lintas paket dari pengidentifikasi VLAN dua diizinkan pada port. Demikian pula, jika bit 1954 diatur ke nol, lalu lintas paket dari pengidentifikasi VLAN 1954 tidak diizinkan pada port.

PvlanProperties

Struktur yang menentukan properti VLAN dengan mode operasi NdisSwitchPortVlanModePrivate. Struktur ini berisi anggota berikut:

PvlanProperties.PvlanMode

Nilai enumerasi NDIS_SWITCH_PORT_PVLAN_MODE yang menentukan mode operasi PVLAN.

PvlanProperties.PrimaryVlanId

Nilai UINT16 yang menentukan pengidentifikasi VLAN utama untuk port sakelar yang dapat diperluas.

Catatan Anggota ini hanya valid jika anggota PvlanMode diatur ke NdisSwitchPortPvlanModeCommunity.

PvlanProperties.SecondaryVlanId

Nilai UINT16 yang menentukan pengidentifikasi VLAN sekunder untuk port sakelar yang dapat diperluas.

Catatan Anggota ini hanya valid jika anggota PvlanMode diatur ke NdisSwitchPortPvlanModeIsolated atau NdisSwitchPortPvlanModeCommunity.

PvlanProperties.SecondaryVlanIdArray[64]

Array elemen UINT64 yang menentukan pengidentifikasi VLAN sekunder untuk port sakelar yang dapat diperluas.

Array memiliki 64 elemen UINT64, yang mewakili 4096 bit berturut-turut. Setiap bit yang memiliki nilai satu menentukan pengidentifikasi VLAN sekunder untuk port sakelar yang dapat diperluas. Misalnya, jika bit lima diatur ke satu, pengidentifikasi VLAN sekunder adalah lima. Demikian pula, jika bit 128 diatur ke nol, 128 tidak dapat digunakan sebagai pengidentifikasi VLAN sekunder.

Catatan Anggota ini hanya valid jika anggota PvlanMode diatur ke NdisSwitchPortPvlanModePromiscuous.

Keterangan

Struktur NDIS_SWITCH_PORT_PROPERTY_VLAN digunakan dalam permintaan set OID berikut:

Struktur NDIS_SWITCH_PORT_PROPERTY_VLAN mengikuti struktur NDIS_SWITCH_PORT_PROPERTY_PARAMETERS dalam buffer yang terkait dengan permintaan set OID ini. Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke buffer ini.

Properti port, seperti NDIS_SWITCH_PORT_PROPERTY_VLAN, diberlakukan oleh ekstensi sakelar yang dapat diperluas yang diinstal sebagai ekstensi penerusan. Jenis ekstensi ini memberlakukan aturannya sendiri untuk meneruskan paket, OID, dan indikasi status melalui tumpukan driver sakelar yang dapat diperluas. Hanya ada satu ekstensi penerusan per setiap instans sakelar yang dapat diperluas.

Untuk informasi selengkapnya tentang ekstensi penerusan, lihat Ekstensi Penerusan.

Catatan Jika ekstensi penerusan tidak diinstal, antarmuka sakelar yang dapat diperluas memberlakukan properti port itu sendiri.