struktur NDIS_NIC_SWITCH_VPORT_PARAMETERS (ntddndis.h)
Struktur NDIS_NIC_SWITCH_VPORT_PARAMETERS menentukan konfigurasi untuk port virtual (VPort) pada sakelar adaptor jaringan adaptor jaringan.
Sintaks
typedef struct _NDIS_NIC_SWITCH_VPORT_PARAMETERS {
NDIS_OBJECT_HEADER Header;
ULONG Flags;
NDIS_NIC_SWITCH_ID SwitchId;
NDIS_NIC_SWITCH_VPORT_ID VPortId;
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;
NDIS_NDK_PARAMETERS NdkParams;
NDIS_QOS_SQ_ID QosSqId;
} NDIS_NIC_SWITCH_VPORT_PARAMETERS, *PNDIS_NIC_SWITCH_VPORT_PARAMETERS;
Anggota
Header
Jenis, revisi, dan ukuran struktur NDIS_NIC_SWITCH_VPORT_PARAMETERS . Anggota ini diformat sebagai struktur NDIS_OBJECT_HEADER .
Driver miniport harus mengatur anggota JenisHeader ke NDIS_OBJECT_TYPE_DEFAULT.
Untuk menunjukkan versi struktur NDIS_NIC_SWITCH_VPORT_PARAMETERS , atur anggota RevisiHeader ke salah satu nilai berikut:
NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2
Menambahkan bidang QosSqId untuk NDIS 6.50.
Atur anggota Ukuran ke NDIS_SIZEOF_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2.
NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1
Versi asli untuk NDIS 6.30 dan yang lebih baru.
Atur anggota Ukuran ke NDIS_SIZEOF_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1.
Flags
Nilai ULONG yang berisi bitwise OR dari bendera. Bendera berikut didefinisikan untuk anggota ini.
NDIS_NIC_SWITCH_VPORT_PARAMS_LOOKAHEAD_SPLIT_ENABLED
Bendera ini dicadangkan untuk digunakan di masa mendatang. Driver miniport harus mengabaikan bendera ini.
NDIS_NIC_SWITCH_VPORT_PARAMS_FLAGS_CHANGED
Bendera ini menentukan bahwa anggota Bendera telah diperbarui setelah VPort dibuat. Bendera ini dapat diaktifkan atau dinonaktifkan setelah VPort dibuat dengan menggunakan permintaan set OID_NIC_SWITCH_VPORT_PARAMETERS OID.
Catatan
Bendera ini hanya valid ketika struktur ini digunakan dalam permintaan set OID OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_NAME_CHANGED
Bendera ini menentukan bahwa anggota VPortName telah diperbarui setelah VPort dibuat. Anggota ini dapat diperbarui dengan menggunakan permintaan set OID_NIC_SWITCH_VPORT_PARAMETERS OID.
Catatan
Bendera ini hanya valid ketika struktur ini digunakan dalam permintaan set OID OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_INT_MOD_CHANGED
Bendera ini menentukan bahwa anggota InterruptModeration telah diperbarui setelah VPort dibuat. Anggota ini dapat diperbarui dengan menggunakan permintaan set OID_NIC_SWITCH_VPORT_PARAMETERS OID.
Catatan
Bendera ini hanya valid ketika struktur ini digunakan dalam permintaan set OID OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_STATE_CHANGED
Bendera ini menentukan bahwa anggota VPortState telah diperbarui setelah VPort dibuat. Anggota ini dapat diperbarui dengan menggunakan permintaan set OID_NIC_SWITCH_VPORT_PARAMETERS OID.
Catatan
Bendera ini hanya valid ketika struktur ini digunakan dalam permintaan set OID OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_PROCESSOR_AFFINITY_CHANGED
Bendera ini menentukan bahwa anggota ProcessoryAffinity telah diperbarui setelah VPort dibuat. Afinitas prosesor VPort hanya dapat diperbarui jika VPort dilampirkan ke PF pada adaptor jaringan. Anggota ProcessoryAffinity dapat diperbarui dengan menggunakan permintaan set OID_NIC_SWITCH_VPORT_PARAMETERS OID.
Catatan
Bendera ini hanya valid ketika struktur ini digunakan dalam permintaan set OID OID_NIC_SWITCH_VPORT_PARAMETERS.
NDIS_NIC_SWITCH_VPORT_PARAMS_NUM_QUEUE_PAIRS_CHANGED
Bendera ini menentukan bahwa anggota NumQueuePairs telah diperbarui setelah VPort dibuat. Ketika Virtual Machine Multiple Queues (VMMQ) diaktifkan, jumlah antrean untuk Vport default dan non-default dapat diperbarui. Anggota NumQueuePairs dapat diperbarui dengan menggunakan permintaan set OID OID_NIC_SWITCH_VPORT_PARAMETERS.
SwitchId
Nilai NDIS_NIC_SWITCH_ID yang menentukan pengidentifikasi sakelar tempat VPort akan dibuat.
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.
VPortId
Nilai NDIS_NIC_SWITCH_VPORT_ID yang menentukan pengidentifikasi VPort pada adaptor jaringan. Nilai dialokasikan oleh NDIS, dan unik di seluruh adaptor jaringan.
Nilai VPortId berada dalam rentang dari nol hingga (NumVPorts - 1), di mana NumVPorts adalah jumlah VPort yang telah dikonfigurasi driver miniport pada adaptor jaringan. Driver menentukan nomor ini dalam anggota NumVPorts dari struktur NDIS_NIC_SWITCH_INFO . Driver mengembalikan struktur ini melalui permintaan kueri OID OID_NIC_SWITCH_ENUM_SWITCHES.
Catatan
Pengidentifikasi VPort NDIS_DEFAULT_VPORT_ID disediakan untuk VPort default yang dilampirkan ke PF pada sakelar NIC default.
VPortName
Nilai NDIS_VPORT_NAME yang menentukan nama VPort. Anggota ini berisi deskripsi VPort yang mudah digunakan.
AttachedFunctionId
Nilai NDIS_SRIOV_FUNCTION_ID yang menentukan ID Fungsi Fisik (PF) atau Fungsi Virtual (VF) tempat VPort dilampirkan. Nilai NDIS_PF_FUNCTION_ID menentukan bahwa VPort dilampirkan ke PF. Jika nilainya adalah pengidentifikasi VF yang valid, VPort dilampirkan ke VF.
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 saat ini.
ProcessorAffinity
Nilai GROUP_AFFINITY yang menentukan nomor grup dan bitmap CPU yang dikaitkan dengan VPort ini. Bidang ini hanya valid untuk VPort yang dilampirkan ke PF.
Catatan
Untuk PF VPorts nondefault, nilai GROUP_AFFINITY yang hanya menentukan satu prosesor harus ditentukan saat VPort dibuat. VPort dibuat melalui permintaan metode OID OID_NIC_SWITCH_CREATE_VPORT.
Afinitas prosesor yang terkait dengan VPort nondefault yang terpasang pada PF dapat diubah setelah pembuatan VPort. Afinitas prosesor yang terkait dengan VPort default juga dapat diubah dengan menggunakan permintaan set OID OID_NIC_SWITCH_VPORT_PARAMETERS.
LookaheadSize
Anggota ini dicadangkan untuk digunakan di masa mendatang. Anggota ini harus diatur ke nol.
NdkParams
QosSqId
Mengaitkan vPort dengan Antrean Penjadwal (SQ). Atur bidang ini ke ID SQ yang valid untuk mengaitkan vPort ke SQ. Atur bidang ini ke nol jika tidak ada asosiasi SQ. Untuk informasi selengkapnya tentang NDIS_QOS_SQ_ID, lihat OID_QOS_OFFLOAD_CREATE_SQ.
Keterangan
Struktur ini digunakan dalam permintaan OID OID_NIC_SWITCH_CREATE_VPORT dan OID_NIC_SWITCH_VPORT_PARAMETERS.
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. |
| Server minimum yang didukung | Windows Server 2022 |
| Header | ntddndis.h (termasuk Ndis.h) |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk