struktur NDIS_SWITCH_PORT_PROPERTY_SECURITY (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_SWITCH_PORT_PROPERTY_SECURITY menentukan properti kebijakan keamanan untuk port sakelar yang dapat diperluas Hyper-V.

Sintaks

typedef struct _NDIS_SWITCH_PORT_PROPERTY_SECURITY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  BOOLEAN            AllowMacSpoofing;
  BOOLEAN            AllowIeeePriorityTag;
  UINT32             VirtualSubnetId;
  BOOLEAN            AllowTeaming;
  UINT32             DynamicIPAddressLimit;
} NDIS_SWITCH_PORT_PROPERTY_SECURITY, *PNDIS_SWITCH_PORT_PROPERTY_SECURITY;

Anggota

Header

Jenis, revisi, dan ukuran struktur NDIS_SWITCH_PORT_PROPERTY_SECURITY . 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_SECURITY , anggota RevisiHeader harus diatur ke nilai berikut:

NDIS_SWITCH_PORT_PROPERTY_SECURITY_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_SECURITY_REVISION_1.

Flags

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

AllowMacSpoofing

Nilai BOOLEAN yang, jika diatur ke TRUE, menentukan bahwa port diizinkan untuk mengirim paket dengan alamat kontrol akses media sumber (MAC) yang berbeda dari alamat MAC permanennya. Alamat MAC permanen port dikonfigurasi melalui permintaan set pengidentifikasi objek (OID) OID_SWITCH_NIC_CREATE.

AllowIeeePriorityTag

Nilai BOOLEAN yang, jika diatur ke TRUE, menentukan bahwa port harus mempertahankan informasi prioritas 802.1Q dalam struktur NET_BUFFER_LIST paket saat paket diteruskan ke port. Port harus mempertahankan informasi prioritas hanya jika anggota PreservePriority diatur dalam penyatuan NDIS_SWITCH_FORWARDING_DETAIL_NET_BUFFER_LIST_INFO data out-of-band dari struktur NET_BUFFER_LIST paket.

VirtualSubnetId

Nilai UINT32 yang menentukan virtualisasi jaringan VirtualSubnetId yang dikonfigurasi pada port. Jika virtualisasi jaringan tidak dikonfigurasi pada port, nilainya adalah 0. Data out-of-band NDIS_NET_BUFFER_LIST_VIRTUAL_SUBNET_INFO NET_BUFFER_LIST berisi VirtualSubnetId, yang diisi dengan keanggotaan subnet virtual lalu lintas.

AllowTeaming

Nilai BOOLEAN yang, jika diatur ke TRUE, menentukan bahwa failover tim untuk port diizinkan, sehingga port dapat mengirim paket dengan alamat kontrol akses media sumber (MAC) yang berbeda dari PermanentMacAddress-nya, tetapi sama dengan alamat MAC yang saat ini digunakan oleh port lain yang terhubung ke komputer virtual yang sama. Alamat MAC permanen port dikonfigurasi melalui permintaan set pengidentifikasi objek (OID) OID_SWITCH_NIC_CREATE/OID_SWITCH_NIC_UPDATE.

DynamicIPAddressLimit

Nilai UINT32 yang menentukan jumlah maksimum alamat IP dinamis yang dapat dipelajari untuk port.

Keterangan

Struktur NDIS_SWITCH_PORT_PROPERTY_SECURITY digunakan dalam permintaan set OID berikut:

Struktur NDIS_SWITCH_PORT_PROPERTY_SECURITY 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_SECURITY, 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.