struktur NDIS_SWITCH_NIC_PARAMETERS (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_SWITCH_NIC_PARAMETERS menentukan parameter konfigurasi untuk adaptor jaringan (NIC) yang terhubung ke port sakelar yang dapat diperluas Hyper-V.

Sintaks

typedef struct _NDIS_SWITCH_NIC_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_SWITCH_NIC_NAME         NicName;
  NDIS_SWITCH_NIC_FRIENDLYNAME NicFriendlyName;
  NDIS_SWITCH_PORT_ID          PortId;
  NDIS_SWITCH_NIC_INDEX        NicIndex;
  NDIS_SWITCH_NIC_TYPE         NicType;
  NDIS_SWITCH_NIC_STATE        NicState;
  NDIS_VM_NAME                 VmName;
  NDIS_VM_FRIENDLYNAME         VmFriendlyName;
  GUID                         NetCfgInstanceId;
  ULONG                        MTU;
  USHORT                       NumaNodeId;
  UCHAR                        PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                        VMMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                        CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  BOOLEAN                      VFAssigned;
  ULONG64                      NdisReserved[2];
} NDIS_SWITCH_NIC_PARAMETERS, *PNDIS_SWITCH_NIC_PARAMETERS;

Anggota

Header

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

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

NDIS_SWITCH_NIC_PARAMETERS_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_SWITCH_NIC_PARAMETERS_REVISION_1.

Flags

Nilai ULONG yang berisi bitwise ATAU bendera. Nilai bendera berikut ditentukan.

Nilai	Makna
NDIS_SWITCH_NIC_FLAGS_NIC_INITIALIZING	Bendera ini diatur ketika OID_SWITCH_NIC_CREATE OID dikeluarkan untuk pertama kalinya dalam masa pakai objek NIC VM. Jika bendera ini diatur: Ekstensi Hyper-V Extensible Switch dapat secara opsional mengurangi nilai anggota MTU dalam struktur NDIS_SWITCH_NIC_PARAMETERS jika perlu memesan headroom untuk enkapsulasi sebelum melewati OID ke bawah tumpukan. Ekstensi tidak akan dapat memesan headroom enkapsulasi untuk jenis NIC lainnya. Ekstensi tidak boleh meningkatkan nilai MTU . Bendera ini akan diatur hanya jika anggota NicType adalah NdisSwitchNicTypeSynthetic.

Nilai

Makna

NDIS_SWITCH_NIC_FLAGS_NIC_INITIALIZING

Bendera ini diatur ketika OID_SWITCH_NIC_CREATE OID dikeluarkan untuk pertama kalinya dalam masa pakai objek NIC VM. Jika bendera ini diatur:

Ekstensi Hyper-V Extensible Switch dapat secara opsional mengurangi nilai anggota MTU dalam struktur NDIS_SWITCH_NIC_PARAMETERS jika perlu memesan headroom untuk enkapsulasi sebelum melewati OID ke bawah tumpukan. Ekstensi tidak akan dapat memesan headroom enkapsulasi untuk jenis NIC lainnya.
Ekstensi tidak boleh meningkatkan nilai MTU .

Bendera ini akan diatur hanya jika anggota NicType adalah NdisSwitchNicTypeSynthetic.

NicName

Nilai NDIS_SWITCH_NIC_NAME yang menentukan nama internal unik adaptor jaringan yang terhubung ke port sakelar yang dapat diperluas.

Untuk informasi lebih lanjut, lihat bagian Keterangan.

NicFriendlyName

Nilai NDIS_SWITCH_NIC_FRIENDLYNAME yang menentukan deskripsi adaptor jaringan yang mudah digunakan.

PortId

Nilai NDIS_SWITCH_PORT_ID yang berisi pengidentifikasi unik port sakelar yang dapat diperluas tempat adaptor jaringan tersambung.

NicIndex

Nilai NDIS_SWITCH_NIC_INDEX yang menentukan indeks adaptor jaringan yang tersambung ke port sakelar yang dapat diperluas yang ditentukan oleh anggota PortId .

Untuk informasi selengkapnya tentang nilai NDIS_SWITCH_NIC_INDEX, lihat Nilai Indeks Adaptor Jaringan.

NicType

Nilai NDIS_SWITCH_NIC_TYPE yang menentukan jenis adaptor jaringan yang tersambung ke port sakelar yang dapat diperluas.

NicState

Nilai NDIS_SWITCH_NIC_STATE yang menentukan status adaptor jaringan saat ini.

VmName

Nilai NDIS_VM_NAME yang menentukan nama internal unik partisi anak Hyper-V tempat sistem operasi tamu yang mengekspos adaptor jaringan sedang berjalan.

Partisi anak Hyper-V juga dikenal sebagai komputer virtual (VM).

Catatan Anggota ini hanya berlaku jika anggota NicType berisi nilai NdisSwitchNicSyntheticNic atau NdisSwitchNicEmulatedNic.

VmFriendlyName

NetCfgInstanceId

Nilai GUID yang menentukan nilai registri NetCfgInstanceId dari adaptor jaringan yang mendasar.

Catatan Anggota ini hanya valid jika anggota NicType diatur ke NdisSwitchNicTypeExternal atau NdisSwitchNicTypeInternal. NetCfgInstanceId tidak akan valid sampai setelah adaptor jaringan virtual diinisialisasi.

MTU

Nilai ULONG yang menentukan ukuran unit transmisi maksimum (MTU), dalam byte, untuk adaptor jaringan.

Catatan Nilai anggota ini dapat berubah selama masa pakai VM NIC. Oleh karena itu, ekstensi harus membaca anggota struktur NDIS_SWITCH_NIC_PARAMETERS ini yang diturunkan dengan OID berikut:

NumaNodeId

Nilai USHORT yang menentukan pengidentifikasi untuk simpul Non-Uniform Memory Access (NUMA) pilihan dari CPU. Pada komputer yang mendukung arsitektur NUMA, simpul NUMA pilihan adalah CPU yang memiliki jarak terkecil ke adaptor jaringan.

Catatan Anggota ini hanya valid jika anggota NicType diatur ke NdisSwitchNicTypeSynthetic atau NdisSwitchNicTypeEmulated.

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Array UCHAR yang menentukan alamat kontrol akses media (MAC) seperti yang dikonfigurasi pada partisi host untuk adaptor jaringan. Ini bisa berbeda dari alamat MAC yang saat ini digunakan oleh adaptor jaringan.

VMMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Array UCHAR yang menentukan alamat MAC yang dikonfigurasi pada adaptor jaringan di dalam VM itu sendiri. Bidang ini semuanya nol untuk NIC non VM. Jika AllowMacSpoofing (dari NDIS_SWITCH_PORT_PROPERTY_SECURITY) TRUE, alamat ini juga akan diterapkan ke CurrentMacAddress.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Array UCHAR yang menentukan alamat MAC yang saat ini sedang digunakan dalam sakelar untuk adaptor jaringan. Jika AllowMacSpoofing dan AllowTeaming keduanya FALSE, maka nilai ini akan sama dengan PermanentMacAddress. Jika AllowMacSpoofing TRUE, nilai ini akan sama dengan VMMacAddress. Jika AllowTeaming TRUE dan failover tim telah terjadi di dalam VM, CurrentMacAddress akan sama dengan alamat MAC yang di-failover ke adaptor jaringan atau PermanentMacAddress jika tidak ada failover yang terjadi.

VFAssigned

Nilai BOOLEAN yang, jika diatur ke TRUE, menentukan bahwa adaptor jaringan dilampirkan ke fungsi virtual (VF) PCI Express (PCIe). VF diekspos oleh adaptor jaringan fisik yang mendasar yang mendukung antarmuka virtualisasi I/O root tunggal (SR-IOV).

Untuk informasi lebih lanjut, lihat bagian Keterangan.

Catatan Anggota VFAssigned hanya valid jika anggota NicType berisi nilai NdisSwitchNicTypeEmulated atau NdisSwitchNicTypeSynthetic. Anggota ini harus diatur ke FALSE jika anggota NicType berisi nilai NdisSwitchNicTypeExternal atau NdisSwitchNicTypeInternal.

NdisReserved[2]

Keterangan

Permintaan kueri OID OID_SWITCH_NIC_ARRAY mengembalikan struktur NDIS_SWITCH_NIC_ARRAY yang berisi nol atau lebih elemen. Setiap elemen diformat sebagai struktur NDIS_SWITCH_NIC_PARAMETERS .

Struktur NDIS_SWITCH_NIC_PARAMETERS juga digunakan dalam permintaan OID berikut:

Catatan Jenis data NDIS_SWITCH_NIC_NAME, NDIS_SWITCH_NIC_FRIENDLYNAME, NDIS_VM_NAME, dan NDIS_VM_FRIENDLYNAME ditentukan oleh struktur IF_COUNTED_STRING . String yang ditentukan oleh struktur ini tidak harus dihentikan null. Namun, panjang string harus diatur dalam anggota Panjang struktur ini. Jika string dihentikan null, anggota Panjang tidak boleh menyertakan karakter null yang mengakhiri.

Panduan untuk Anggota NicType dan NicName

Berdasarkan nilai anggota NicType , format anggota NicName adalah sebagai berikut:

Jika anggota NicType diatur ke NdisSwitchNicTypeExternal, nilai anggota NicName adalah pengidentifikasi instans unik (InstanceId) dari adaptor jaringan fisik yang terikat ke adaptor jaringan eksternal. Jenis adaptor jaringan ini diekspos dalam sistem operasi manajemen yang berjalan di partisi induk Hyper-V.
Adaptor jaringan eksternal menyediakan koneksi ke antarmuka jaringan fisik yang tersedia di host. Adaptor jaringan eksternal dapat diakses oleh partisi induk Hyper-V dan semua partisi anak.

Catatan Nilai InstanceId dihasilkan oleh manajer Plug and Play yang berjalan dalam sistem operasi manajemen.
Jika anggota NicType diatur ke NdisSwitchNicTypeInternal, nilai anggota NicName adalah nama tampilan perangkat yang mengidentifikasi adaptor jaringan internal. Jenis adaptor jaringan ini diekspos dalam sistem operasi manajemen partisi induk Hyper-V.
Adaptor jaringan internal dapat diakses oleh partisi induk Hyper-V dan semua partisi anak. Namun, adaptor jaringan internal tidak tersambung ke antarmuka jaringan fisik yang tersedia di host.

Catatan Nama tampilan perangkat dihasilkan oleh lapisan manajemen Hyper-V WMI yang berjalan dalam sistem operasi manajemen.
Untuk semua nilai anggota NicType lainnya, nilai anggota NicName secara unik ditetapkan ke adaptor jaringan sintetis atau ditiru oleh antarmuka manajemen kebijakan. Jenis adaptor jaringan ini diekspos dalam sistem operasi tamu yang berjalan adalah partisi anak Hyper-V.

Panduan untuk Anggota VFAssigned

PCIe VF dibuat dan dialokasikan oleh adaptor fisik dasar yang mendukung antarmuka SR-IOV. Setelah PCIe VF dibuat, tumpukan virtualisasi melampirkan, atau menetapkan, partisi anak Hyper-V ke VF. Sistem operasi tamu yang berjalan dalam partisi ini mengekspos adaptor jaringan komputer virtual (VM) yang terpasang, atau ditetapkan ke adaptor fisik SR-IOV yang mendasarinya.

Jika anggota VFAssigned diatur ke TRUE, paket dirutekan langsung antara adaptor jaringan fisik SR-IOV yang mendasar dan adaptor virtual. Namun, karena sakelar yang dapat diperluas tidak terlibat dalam pengiriman paket, kebijakan port sakelar yang dapat diperluas, seperti daftar kontrol akses (ACL), tidak diterapkan ke paket ini.

Ekstensi dapat menghapus penugasan VF dengan mengeluarkan indikasi status NDIS_STATUS_SWITCH_PORT_REMOVE_VF . Indikasi ini menyebabkan paket dikirimkan melalui port sakelar yang dapat diperluas alih-alih langsung antara adaptor jaringan VM dan adaptor fisik SR-IOV. Ini memungkinkan kebijakan port switch yang dapat diperluas diterapkan ke paket yang diterima atau dikirim melalui port sakelar yang dapat diperluas. Ketika ekstensi membuat indikasi status NDIS_STATUS_SWITCH_PORT_REMOVE_VF , ekstensi menentukan port sakelar yang dapat diperluas yang tersambung dengan adaptor jaringan virtual.

Untuk informasi selengkapnya, lihat NDIS_STATUS_SWITCH_PORT_REMOVE_VF.