struktur NDIS_NIC_SWITCH_VPORT_INFO (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_NIC_SWITCH_VPORT_INFO menentukan konfigurasi untuk port virtual (VPort) pada sakelar adaptor jaringan adaptor jaringan.

Sintaks

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO {
  NDIS_OBJECT_HEADER                         Header;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  NDIS_VPORT_NAME                            VPortName;
  NDIS_SRIOV_FUNCTION_ID                     AttachedFunctionId;
  ULONG                                      NumQueuePairs;
  NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION InterruptModeration;
  NDIS_NIC_SWITCH_VPORT_STATE                VPortState;
  GROUP_AFFINITY                             ProcessorAffinity;
  ULONG                                      LookaheadSize;
  ULONG                                      NumFilters;
} NDIS_NIC_SWITCH_VPORT_INFO, *PNDIS_NIC_SWITCH_VPORT_INFO;

Anggota

Header

Jenis, revisi, dan ukuran struktur NDIS_NIC_SWITCH_VPORT_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_VPORT_INFO , driver harus mengatur anggota RevisiHeader ke nilai berikut:

NDIS_NIC_SWITCH_VPORT_INFO_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_REVISION_1.

VPortId

Nilai NDIS_NIC_SWITCH_VPORT_ID yang secara unik mengidentifikasi port virtual (VPort) pada adaptor jaringan.

Nilai NDIS_DEFAULT_VPORT_ID menentukan VPort default pada sakelar. VPort default selalu dilampirkan ke Fungsi Fisik (PF) PCI Express (PCIe) adaptor jaringan.

Catatan VPort nondefault dengan nilai VPortId yang ditentukan sebelumnya harus dibuat melalui permintaan metode OID OID_NIC_SWITCH_CREATE_VPORT.

Flags

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

SwitchId

Nilai NDIS_NIC_SWITCH_ID yang secara unik mengidentifikasi sakelar adaptor jaringan yang dibuat pada adaptor jaringan. VPort yang diidentifikasi melalui anggota VPortId dibuat pada sakelar yang ditentukan oleh anggota SwitchId .

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.

VPortName

Nilai NDIS_VPORT_NAME yang menentukan nama VPort yang dibuat pada sakelar adaptor jaringan. Anggota ini berisi deskripsi VPort yang mudah digunakan.

AttachedFunctionId

Nilai NDIS_SRIOV_FUNCTION_ID yang menentukan pengidentifikasi VF atau PF tempat VPort dilampirkan.

Catatan Jika nilai ini NDIS_PF_FUNCTION_ID, VPort dilampirkan ke PF.

NumQueuePairs

Nilai ULONG yang menentukan jumlah pasangan antrean yang dikonfigurasi untuk VPort ini.

Pasangan antrean terdiri dari antrean transmisi dan menerima antrean. Pasangan antrean yang terkait dengan VPort default dikonfigurasi pada saat pembuatan sakelar melalui permintaan metode OID OID_NIC_SWITCH_CREATE_SWITCH. Satu atau beberapa pasangan antrean dikonfigurasi pada VPort nondefault melalui permintaan metode OID OID_NIC_SWITCH_CREATE_VPORT.

InterruptModeration

Nilai NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION yang menentukan pengaturan moderasi interupsi VPort.

VPortState

Nilai NDIS_NIC_SWITCH_VPORT_STATE yang menentukan status VPort.

ProcessorAffinity

Nilai GROUP_AFFINITY yang menentukan nomor grup dan bitmap CPU yang dapat dikaitkan dengan VPort ini.

Anggota ini hanya berlaku untuk VPort yang dilampirkan ke PF. Bidang ini tidak valid untuk VPort nondefault yang dilampirkan ke VF.

LookaheadSize

Anggota ini dicadangkan untuk digunakan di masa mendatang. Anggota ini harus diatur ke nol.

NumFilters

Nilai ULONG yang menentukan jumlah filter terima yang telah dikonfigurasi pada adaptor jaringan.

Catatan Dimulai dengan NDIS 6.30, driver miniport harus mempertahankan penghitung untuk jumlah filter penerima saat ini yang diatur pada adaptor jaringan. Driver harus menaikkan penghitung setiap kali filter penerima diatur melalui permintaan set OID OID_RECEIVE_FILTER_SET_FILTER. Driver juga harus menurunkan penghitung setiap kali filter penerima dibersihkan melalui permintaan set OID OID_RECEIVE_FILTER_CLEAR_FILTER.

Keterangan

Struktur NDIS_NIC_SWITCH_VPORT_INFO berisi informasi tentang salah satu hal berikut ini:

VPort nondefault yang sebelumnya dibuat melalui permintaan metode OID OID_NIC_SWITCH_CREATE_VPORT.
VPort default yang dilampirkan ke PF. VPort default selalu ada dan tidak dapat dihapus.

Satu atau beberapa struktur NDIS_NIC_SWITCH_VPORT_INFO dikembalikan melalui struktur NDIS_NIC_SWITCH_VPORT_INFO_ARRAY .

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