struktur NDIS_NIC_SWITCH_CAPABILITIES (ntddndis.h)

  • Artikel

Struktur NDIS_NIC_SWITCH_CAPABILITIES menentukan kemampuan sakelar NIC pada adaptor jaringan.

Sintaks

typedef struct _NDIS_NIC_SWITCH_CAPABILITIES {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              NdisReserved1;
  ULONG              NumTotalMacAddresses;
  ULONG              NumMacAddressesPerPort;
  ULONG              NumVlansPerPort;
  ULONG              NdisReserved2;
  ULONG              NdisReserved3;
  ULONG              NicSwitchCapabilities;
  ULONG              MaxNumSwitches;
  ULONG              MaxNumVPorts;
  ULONG              NdisReserved4;
  ULONG              MaxNumVFs;
  ULONG              MaxNumQueuePairs;
  ULONG              NdisReserved5;
  ULONG              NdisReserved6;
  ULONG              NdisReserved7;
  ULONG              MaxNumQueuePairsPerNonDefaultVPort;
  ULONG              NdisReserved8;
  ULONG              NdisReserved9;
  ULONG              NdisReserved10;
  ULONG              NdisReserved11;
  ULONG              NdisReserved12;
  ULONG              MaxNumMacAddresses;
  ULONG              NdisReserved13;
  ULONG              NdisReserved14;
  ULONG              NdisReserved15;
  ULONG              NdisReserved16;
  ULONG              NdisReserved17;
  ULONG              MaxNumRssCapableNonDefaultPFVPorts;
  ULONG              NumberOfIndirectionTableEntriesForDefaultVPort;
  ULONG              NumberOfIndirectionTableEntriesPerNonDefaultPFVPort;
  ULONG              MaxNumQueuePairsForDefaultVPort;
} NDIS_NIC_SWITCH_CAPABILITIES, *PNDIS_NIC_SWITCH_CAPABILITIES;

Anggota

Header

Jenis, revisi, dan ukuran struktur NDIS_NIC_SWITCH_CAPABILITIES . 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_CAPABILITIES , driver harus mengatur anggota RevisiHeader ke salah satu nilai berikut:

NDIS_NIC_SWITCH_CAPABILITIES_REVISION_3

Menambahkan anggota antarmuka RSS untuk NDIS 6.60.

Catatan Revisi 3 struktur ini hanya didukung pada Windows Server 2016 dan versi Windows Server yang lebih baru.

 

Atur anggota Ukuran ke NDIS_SIZEOF_NIC_SWITCH_CAPABILITIES_REVISION_3.

NDIS_NIC_SWITCH_CAPABILITIES_REVISION_2

Menambahkan anggota antarmuka virtualisasi I/O root tunggal (SR-IOV) untuk NDIS 6.30.

Catatan Revisi 2 struktur ini hanya didukung pada Windows Server 2012 dan versi Windows Server yang lebih baru.

 

Atur anggota Ukuran ke NDIS_SIZEOF_NIC_SWITCH_CAPABILITIES_REVISION_2.

NDIS_NIC_SWITCH_CAPABILITIES_REVISION_1

Versi asli untuk NDIS 6.20.

Atur anggota Ukuran ke NDIS_SIZEOF_NIC_SWITCH_CAPABILITIES_REVISION_1.

Flags

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

NdisReserved1

Dicadangkan untuk NDIS.

NumTotalMacAddresses

Nilai ULONG yang berisi jumlah total alamat kontrol akses media (MAC) yang didukung adaptor jaringan.

Catatan Driver harus mengatur anggota ini ke nol untuk revisi 2 dan revisi yang lebih baru dari struktur ini.
 

NumMacAddressesPerPort

Nilai ULONG yang berisi jumlah alamat MAC yang didukung untuk setiap port.

Catatan Driver harus mengatur anggota ini ke nol untuk revisi 2 dan revisi yang lebih baru dari struktur ini.
 

NumVlansPerPort

Nilai ULONG yang berisi jumlah VLAN yang didukung untuk setiap port.

Catatan Driver harus mengatur anggota ini ke nol untuk revisi 2 dan revisi yang lebih baru dari struktur ini.
 

NdisReserved2

Dicadangkan untuk NDIS.

NdisReserved3

Dicadangkan untuk NDIS.

NicSwitchCapabilities

Nilai ULONG yang berisi bitwise ATAU dari bendera berikut yang menentukan kemampuan sakelar NIC:

NDIS_NIC_SWITCH_CAPS_RSS_ON_PF_VPORTS_SUPPORTED

Catatan Bendera ini didukung di Windows Server 2016 dan yang lebih baru. Ini diperkenalkan di NDIS 6.60.

Menentukan bahwa NIC mendukung VMMQ untuk PF VPorts.

NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_INDIRECTION_TABLE_SUPPORTED

Catatan Bendera ini didukung di Windows Server 2016 dan yang lebih baru. Ini diperkenalkan di NDIS 6.60.

Jika diatur ke 1, menentukan bahwa NIC dapat mempertahankan tabel tidak langsung per-PF VPort.

NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_HASH_FUNCTION_SUPPORTED

Catatan Bendera ini didukung di Windows Server 2016 dan yang lebih baru. Ini diperkenalkan di NDIS 6.60.

Jika diatur ke 1, menentukan bahwa NIC mendukung pengaturan fungsi hash yang berbeda per PF VPort. Jika bendera ini diatur, NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_HASH_KEY_SUPPORTED juga harus diatur.

NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_HASH_TYPE_SUPPORTED

Catatan Bendera ini didukung di Windows Server 2016 dan yang lebih baru. Ini diperkenalkan di NDIS 6.60.

Jika diatur ke 1, menentukan bahwa NIC mendukung pengaturan jenis hash yang berbeda per PF VPort.

NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_HASH_KEY_SUPPORTED

Catatan Bendera ini didukung di Windows Server 2016 dan yang lebih baru. Ini diperkenalkan di NDIS 6.60.

Jika diatur ke 1, menentukan bahwa NIC mendukung pengaturan kunci rahasia hash yang berbeda per PF VPort. Bendera ini harus diatur jika NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_HASH_FUNCTION_SUPPORTED diatur.

NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_INDIRECTION_TABLE_SIZE_RESTRICTED

Catatan Bendera ini didukung di Windows Server 2016 dan yang lebih baru. Ini diperkenalkan di NDIS 6.60.

Jika diatur ke 1, menentukan bahwa NIC memiliki batasan ukuran tabel tidak langsung untuk PF VPorts. Bendera ini memaksa penerbit OID RSS untuk menggunakan ukuran tabel tidak langsung per-PF VPort yang sama dengan jumlah antrean VPort yang dibulatkan ke daya berikutnya yaitu dua. Ini hanya berlaku untuk PF VPorts dan tidak berlaku untuk VF VPorts. Bendera ini dapat dikombinasikan dengan bendera NDIS_NIC_SWITCH_CAPS_ASYMMETRIC_QUEUE_PAIRS_FOR_NONDEFAULT_VPORT_SUPPORTED (PF VPorts yang berbeda dapat memiliki jumlah antrean yang berbeda). Bendera ini mencegah pengguna VMMQ melakukan kemudi antrean halus.

NDIS_NIC_SWITCH_CAPS_NIC_SWITCH_WITHOUT_IOV_SUPPORTED

Catatan Bendera ini didukung di Windows Server 2016 dan yang lebih baru.

Bendera ini, yang diperkenalkan dengan NDIS 6.60, menentukan bahwa sakelar NIC dapat dibuat tanpa menggunakan SR-IOV. Bendera ini memungkinkan pemisahan sakelar NIC dari kata kunci *SRIOV, yang berarti bahwa sakelar NIC dapat dibuat melalui OID_NIC_SWITCH_CREATE_SWITCH bahkan jika *SRIOV = 0.

Untuk informasi selengkapnya tentang melaporkan kemampuan sakelar NIC untuk driver miniport NDIS 6.60 dan yang lebih baru, lihat Menentukan Kemampuan Sakelar NIC.

NDIS_NIC_SWITCH_CAPS_VLAN_SUPPORTED

Bendera ini menentukan bahwa sakelar NIC mendukung pemfilteran paket perangkat keras berdasarkan pengidentifikasi (ID) jaringan area lokal virtual (VLAN).

Catatan Bendera ini harus diatur hanya jika sakelar NIC mendukung pemfilteran ID VLAN pada port virtual (VPorts) SR-IOV individual.
 

NDIS_NIC_SWITCH_CAPS_PER_VPORT_INTERRUPT_MODERATION_SUPPORTED

Bendera ini menentukan bahwa sakelar NIC dapat mendukung konfigurasi moderasi interupsi pada masing-masing VPort.

NDIS_NIC_SWITCH_CAPS_ASYMMETRIC_QUEUE_PAIRS_FOR_NONDEFAULT_VPORT_SUPPORTED

Bendera ini menentukan bahwa sakelar NIC dapat mengonfigurasi jumlah pasangan antrean yang berbeda untuk setiap VPort nondefault. Ini berarti bahwa setiap VPort nondefault dapat dikonfigurasi secara asimetris untuk memiliki jumlah pasangan antrean yang berbeda.

Jika bendera ini tidak diatur, semua VPort nondefault harus dikonfigurasi secara simetris agar memiliki jumlah pasangan antrean yang sama.

Terlepas dari apakah bendera ini diatur, sakelar NIC harus mendukung kemampuan untuk mengatur jumlah pasangan antrean pada VPort default. Ini mungkin berbeda dari jumlah pasangan antrean yang diatur pada VPorts nondefault.

Catatan 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.
 
Untuk informasi selengkapnya, lihat Penetapan Pasangan Antrean Simetris dan Asimetris.

NDIS_NIC_SWITCH_CAPS_VF_RSS_SUPPORTED

Bendera ini menentukan bahwa pasangan antrean dari VPort nondefault yang dilampirkan ke Fungsi Virtual (VF) PCI Express (PCIe) dapat digunakan untuk menerima penskalaan sisi (RSS). Driver miniport VF berjalan dalam sistem operasi tamu partisi anak Hyper-V.

Jika bendera ini diatur, driver miniport mendukung RSS pada VF dan dapat menggunakan satu atau beberapa pasangan antrean dari VPort nondefault untuk RSS.

Catatan Dimulai dengan Windows Server 2012, hanya satu VPort nondefault yang dapat dilampirkan ke VF.
 

NDIS_NIC_SWITCH_CAPS_SINGLE_VPORT_POOL

Bendera ini menentukan bahwa VPort nondefault dapat dibuat dengan cara yang tidak dipesan dari kumpulan VPort pada adaptor jaringan. Hal ini memungkinkan VPort nondefault yang tersedia untuk dibuat dan ditetapkan sesuai kebutuhan untuk PF dan VF yang dialokasikan. Jika adaptor jaringan mendukung antarmuka antrean komputer virtual (VMQ), VPort nondefault yang ditetapkan ke PF juga dapat digunakan untuk VM menerima antrean.

Catatan VPort default selalu dicadangkan untuk penugasan ke PF.
 
Jika bendera ini diatur, VPort nondefault yang tersedia dibuat dan ditetapkan ke PF dan VF yang dialokasikan. Namun, mekanisme ini tidak mencadangkan VPorts nondefault untuk pembuatan dan penugasan VF. Akibatnya, situasi dapat terjadi di mana VF mungkin tidak ditetapkan VPort jika kumpulan telah kelelahan dengan VPort yang tersedia.
Catatan Jika VF tidak dapat ditetapkan VPort, lalu lintas paket melalui VF terjadi melalui jalur data sintetis SR-IOV. Untuk informasi selengkapnya tentang jalur data ini, lihat Jalur Data SR-IOV.
 
Jika bendera ini tidak diatur, pembuatan dan penugasan VPorts nondefault dicadangkan untuk penugasan VF. VPorts nondefault tambahan dapat dibuat dan ditetapkan ke PF.

Untuk informasi selengkapnya tentang VMQ, lihat Virtual Machine Queue (VMQ).

Untuk informasi selengkapnya tentang VPorts, lihat Mengelola Port Virtual.

MaxNumSwitches

Nilai ULONG yang menentukan jumlah maksimum sakelar yang dapat dibuat pada Fungsi Fisik (PF) PCI Express (PCIe) adaptor jaringan.

Catatan Dimulai dengan Windows Server 2012, Windows hanya mendukung sakelar NIC default pada adaptor jaringan. Oleh karena itu, anggota ini harus selalu diatur ke satu.
 

MaxNumVPorts

Nilai ULONG yang menentukan jumlah maksimum VPort yang dapat dibuat pada adaptor jaringan. Ini termasuk VPort default yang selalu dilampirkan ke PF.

Catatan Sakelar NIC harus mendukung setidaknya (MaxNumVFs + 1) VPorts.
 

NdisReserved4

Dicadangkan untuk NDIS.

MaxNumVFs

Nilai ULONG yang menentukan jumlah maksimum VF yang dapat dibuat pada sakelar NIC.

Catatan Bergantung pada sumber daya perangkat keras yang tersedia pada adaptor jaringan, driver miniport dapat mengatur anggota MaxNumVFs ke nilai yang kurang dari kata kunci *NumVFs-nya . Untuk informasi selengkapnya tentang kata kunci ini, lihat Kata Kunci INF Standar untuk SR-IOV.
 

MaxNumQueuePairs

Nilai ULONG yang menentukan jumlah maksimum pasangan antrean yang dapat ditetapkan ke semua VPort. Ini termasuk VPort default yang dilampirkan ke PF.

Catatan Nilai ini harus lebih besar dari atau sama dengan nilai MaxNumVPorts.
 

NdisReserved5

Dicadangkan untuk NDIS.

NdisReserved6

Dicadangkan untuk NDIS.

NdisReserved7

Dicadangkan untuk NDIS.

MaxNumQueuePairsPerNonDefaultVPort

Nilai ULONG yang menentukan jumlah maksimum pasangan antrean yang dapat ditetapkan ke VPort nondefault.

Nilai ini ditentukan dalam kekuatan 2, dan menyediakan konfigurasi asimetris dan penugasan pasangan antrean ke VPorts. Untuk informasi selengkapnya, lihat Penetapan Pasangan Antrean Simetris dan Asimetris.

NdisReserved8

Dicadangkan untuk NDIS.

NdisReserved9

Dicadangkan untuk NDIS.

NdisReserved10

Dicadangkan untuk NDIS.

NdisReserved11

Dicadangkan untuk NDIS.

NdisReserved12

Dicadangkan untuk NDIS.

MaxNumMacAddresses

Nilai ULONG yang menentukan jumlah maksimum filter alamat MAC unicast yang tersedia pada sakelar NIC.

Catatan Nilai ini harus lebih besar dari atau sama dengan nilai MaxNumVPorts. Ini memungkinkan setiap VPort (termasuk VPort default) untuk dikonfigurasi agar memiliki setidaknya satu filter alamat MAC unicast.
 

NdisReserved13

Dicadangkan untuk NDIS.

NdisReserved14

Dicadangkan untuk NDIS.

NdisReserved15

Dicadangkan untuk NDIS.

NdisReserved16

Dicadangkan untuk NDIS.

NdisReserved17

Dicadangkan untuk NDIS.

MaxNumRssCapableNonDefaultPFVPorts

Nilai ULONG yang menentukan jumlah maksimum PFVPorts non-default berkemampuan RSS.

NumberOfIndirectionTableEntriesForDefaultVPort

Nilai ULONG yang menentukan jumlah entri tabel tidak langsung untuk VPort default.

NumberOfIndirectionTableEntriesPerNonDefaultPFVPort

Nilai ULONG yang menentukan jumlah entri tabel tidak langsung untuk setiap PFVPort non-default.

MaxNumQueuePairsForDefaultVPort

Nilai ULONG yang menentukan jumlah maksimum pasangan antrean yang dapat ditetapkan ke VPort default.

Nilai ini ditentukan dalam kekuatan 2, dan menyediakan konfigurasi asimetris dan penugasan pasangan antrean ke VPorts. Untuk informasi selengkapnya, lihat Penetapan Pasangan Antrean Simetris dan Asimetris.

Keterangan

Struktur NDIS_NIC_SWITCH_CAPABILITIES digunakan dalam anggota struktur berikut:

Permintaan kueri OID dari OID_NIC_SWITCH_CURRENT_CAPABILITIES dan OID_NIC_SWITCH_HARDWARE_CAPABILITIES mengembalikan struktur NDIS_NIC_SWITCH_CAPABILITIES .

Persyaratan

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

Lihat juga

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_CURRENT_CAPABILITIES

OID_NIC_SWITCH_HARDWARE_CAPABILITIES