struktur NDIS_NIC_SWITCH_VF_INFO (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_NIC_SWITCH_VF_INFO menentukan informasi tentang Fungsi Virtual (VF) PCI Express (PCIe) yang telah dialokasikan pada adaptor jaringan.

Sintaks

typedef struct _NDIS_NIC_SWITCH_VF_INFO {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_VM_NAME           VMName;
  NDIS_VM_FRIENDLYNAME   VMFriendlyName;
  NDIS_SWITCH_NIC_NAME   NicName;
  USHORT                 MacAddressLength;
  UCHAR                  PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                  CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  NDIS_SRIOV_FUNCTION_ID VFId;
  NDIS_VF_RID            RequestorId;
} NDIS_NIC_SWITCH_VF_INFO, *PNDIS_NIC_SWITCH_VF_INFO;

Anggota

Header

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

Driver miniport harus mengatur anggota JenisHeader ke NDIS_OBJECT_TYPE_DEFAULT. Untuk menentukan versi struktur NDIS_NIC_SWITCH_VF_INFO , driver harus mengatur anggota RevisiHeader ke nilai berikut:

NDIS_NIC_SWITCH_VF_INFO_REVISION_1

Versi asli untuk NDIS 6.30.

Atur anggota Ukuran ke NDIS_SIZEOF_NIC_SWITCH_VF_INFO_REVISION_1.

Flags

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

SwitchId

Nilai NDIS_NIC_SWITCH_ID yang menentukan pengidentifikasi sakelar. Pengidentifikasi sakelar adalah bilangan bulat antara nol dan jumlah sakelar yang didukung adaptor jaringan. Nilai NDIS_DEFAULT_SWITCH_ID menunjukkan sakelar adaptor jaringan default.

Catatan Dimulai dengan Windows Server 2012, antarmuka virtualisasi I/O root tunggal (SR-IOV) hanya mendukung sakelar adaptor jaringan default pada adaptor jaringan. Nilai anggota ini harus diatur ke NDIS_DEFAULT_SWITCH_ID.

VMName

Nilai NDIS_VM_NAME yang menentukan nama partisi anak Hyper-V yang dilampirkan ke VF. Anggota ini berisi deskripsi partisi yang mudah digunakan.

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

VMFriendlyName

Nilai NDIS_VM_FRIENDLYNAME yang menentukan nama eksternal partisi anak Hyper-V yang dilampirkan ke VF. Anggota ini berisi deskripsi partisi yang mudah digunakan.

NicName

Nilai NDIS_SWITCH_NIC_NAME yang menentukan nama adaptor jaringan komputer virtual (VM). Anggota ini berisi deskripsi adaptor jaringan yang mudah digunakan.

Adaptor jaringan VM adalah perangkat virtual yang terekspos dalam sistem operasi tamu yang berjalan dalam partisi anak Hyper-V. Tim adaptor jaringan VM dengan adaptor jaringan VF untuk menyediakan jalur data VF berbasis perangkat keras melalui antarmuka SR-IOV.

Untuk informasi selengkapnya tentang jalur data VF, lihat Jalur Data VF SR-IOV.

MacAddressLength

Nilai USHORT yang menentukan panjang anggota PermanentMacAddress dan CurrentMacAddress .

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Alamat MAC permanen VF. Ini adalah alamat MAC permanen untuk adaptor jaringan VF yang terekspos dalam sistem operasi tamu.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Alamat MAC VF saat ini. Ini adalah alamat MAC saat ini untuk adaptor jaringan VF yang terekspos dalam sistem operasi tamu.

VFId

Nilai NDIS_SRIOV_FUNCTION_ID yang menentukan pengidentifikasi unik VF pada adaptor jaringan.

RequestorId

NDIS_VF_RID yang menentukan ID Pemohon PCI Express (PCIe) VF.

Keterangan

Struktur NDIS_NIC_SWITCH_VF_INFO berisi informasi tentang VF yang sebelumnya dibuat melalui permintaan metode OID OID_NIC_SWITCH_ALLOCATE_VF. Ketika permintaan OID ini dikeluarkan, satu atau beberapa struktur NDIS_NIC_SWITCH_VF_INFO dikembalikan dalam struktur NDIS_NIC_SWITCH_VF_INFO_ARRAY .

Untuk informasi selengkapnya tentang antarmuka SR-IOV, lihat Gambaran Umum Virtualisasi I/O Root Tunggal (SR-IOV).

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.30 dan yang lebih baru.
Header	ntddndis.h (termasuk Ndis.h)

Lihat juga

NDIS_NIC_SWITCH_VF_INFO_ARRAY

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ALLOCATE_VF

Share via