struktur NDIS_NIC_SWITCH_INFO (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_NIC_SWITCH_INFO menentukan informasi tentang sakelar adaptor jaringan pada adaptor jaringan.

Sintaks

typedef struct _NDIS_NIC_SWITCH_INFO {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NumAllocatedVFs;
  ULONG                        NumVPorts;
  ULONG                        NumActiveVPorts;
  ULONG                        NumQueuePairsForDefaultVPort;
  ULONG                        NumQueuePairsForNonDefaultVPorts;
  ULONG                        NumActiveDefaultVPortMacAddresses;
  ULONG                        NumActiveNonDefaultVPortMacAddresses;
  ULONG                        NumActiveDefaultVPortVlanIds;
  ULONG                        NumActiveNonDefaultVPortVlanIds;
} NDIS_NIC_SWITCH_INFO, *PNDIS_NIC_SWITCH_INFO;

Anggota

Header

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

NDIS_NIC_SWITCH_INFO_REVISION_1

Versi asli untuk NDIS 6.30.

Atur anggota Ukuran ke NDIS_SIZEOF_NIC_SWITCH_INFO_REVISION_1.

Flags

Nilai ULONG yang berisi bitwise ATAU bendera konfigurasi yang diaktifkan pada sakelar.

Catatan Untuk NDIS 6.30, tidak ada bendera konfigurasi yang ditentukan untuk sakelar. Anggota Bendera harus diatur ke nol.

SwitchType

Nilai NDIS_NIC_SWITCH_TYPE yang menentukan jenis sakelar.

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.

SwitchFriendlyName

Nilai NDIS_NIC_SWITCH_FRIENDLYNAME yang berisi deskripsi sakelar yang mudah digunakan.

NumVFs

Nilai ULONG yang menentukan jumlah Fungsi Virtual (VF) PCI Express (PCIe) yang diaktifkan pada adaptor jaringan. VF yang diaktifkan dapat berada dalam status dialokasikan atau tidak dialokasikan.

NumAllocatedVFs

Nilai ULONG yang menentukan jumlah VF yang telah dialokasikan pada sakelar adaptor jaringan yang ditentukan oleh SwitchId. VF dialokasikan melalui permintaan set OID_NIC_SWITCH_ALLOCATE_VF OID.

NumVPorts

Nilai ULONG yang menentukan jumlah port virtual (VPorts) yang dikonfigurasi pada sakelar adaptor jaringan yang ditentukan oleh SwitchId.

Nilai ULONG ini adalah jumlah dari yang berikut ini:

Jumlah maksimum VPort yang dapat dibuat melalui permintaan set OID OID_NIC_SWITCH_CREATE_VPORT.
VPort default yang dilampirkan ke Fungsi Fisik (PF).

NumActiveVPorts

Nilai ULONG yang menentukan jumlah VPort yang telah dibuat pada sakelar adaptor jaringan yang ditentukan oleh SwitchId.

Catatan Nilai ULONG ini mencakup VPort default, selain VPort nondefault yang dibuat melalui permintaan set OID OID_NIC_SWITCH_CREATE_VPORT.

NumQueuePairsForDefaultVPort

Nilai ULONG yang menentukan jumlah pasangan antrean yang dialokasikan untuk VPort default. VPort default selalu dilampirkan ke PF.

Pasangan antrean terdiri dari antrean transmisi dan menerima antrean. Driver miniport mengaitkan satu atau beberapa pasangan antrean dengan VPort default pada saat pembuatan sakelar melalui permintaan metode OID OID_NIC_SWITCH_CREATE_SWITCH.

Catatan Dimulai dengan NDIS 6.30, hanya ada satu pasangan antrean yang dapat dikonfigurasi untuk VPort default.

NumQueuePairsForNonDefaultVPorts

Nilai ULONG yang menentukan jumlah pasangan antrean yang dialokasikan untuk VPort nondefault. VPort nondefault dapat dilampirkan ke PF atau VF adaptor jaringan apa pun.

Driver miniport mengaitkan satu atau beberapa pasangan antrean dengan VPort nondefault melalui permintaan metode OID OID_NIC_SWITCH_CREATE_VPORT.

NumActiveDefaultVPortMacAddresses

Nilai ULONG yang menentukan jumlah filter alamat MAC unicast yang saat ini diatur pada VPort default yang dilampirkan ke PF adaptor jaringan.

NumActiveNonDefaultVPortMacAddresses

Nilai ULONG yang menentukan jumlah filter alamat MAC unicast yang saat ini diatur pada VPort nondefault.

NumActiveDefaultVPortVlanIds

Nilai ULONG yang menentukan jumlah filter pengidentifikasi jaringan area lokal virtual (VLAN) yang saat ini diatur pada VPort default.

NumActiveNonDefaultVPortVlanIds

Nilai ULONG yang menentukan jumlah filter pengidentifikasi VLAN yang saat ini diatur pada VPorts nondefault.

Keterangan

Struktur NDIS_NIC_SWITCH_INFO digunakan dalam permintaan kueri OID OID_NIC_SWITCH_ENUM_SWITCHES. Permintaan OID ini digunakan untuk menghitung sakelar adaptor jaringan pada adaptor jaringan. Ketika permintaan OID ini dikeluarkan, satu atau beberapa struktur NDIS_NIC_SWITCH_INFO dikembalikan dalam struktur NDIS_NIC_SWITCH_INFO_ARRAY .

Catatan Dimulai dengan NDIS 6.30, hanya NDIS_NIC_SWITCH_INFO yang menjelaskan informasi tentang sakelar adaptor jaringan default yang dikembalikan melalui permintaan OID OID_NIC_SWITCH_ENUM_SWITCHES.

Struktur NDIS_NIC_SWITCH_INFO berisi informasi tentang sakelar adaptor jaringan yang sebelumnya dibuat melalui permintaan metode OID OID_NIC_SWITCH_CREATE_SWITCH.

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