struktur NDIS_NIC_SWITCH_VPORT_INFO_ARRAY (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_NIC_SWITCH_VPORT_INFO_ARRAY menentukan array. Setiap elemen dalam array menentukan atribut port virtual (VPort) yang telah dibuat pada sakelar adaptor jaringan adaptor jaringan.

Sintaks

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO_ARRAY {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_SRIOV_FUNCTION_ID AttachedFunctionId;
  ULONG                  FirstElementOffset;
  ULONG                  NumElements;
  ULONG                  ElementSize;
} NDIS_NIC_SWITCH_VPORT_INFO_ARRAY, *PNDIS_NIC_SWITCH_VPORT_INFO_ARRAY;

Anggota

Header

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

NDIS mengatur anggota JenisHeader ke NDIS_OBJECT_TYPE_DEFAULT. Untuk menentukan versi struktur NDIS_NIC_SWITCH_VPORT_INFO_ARRAY , NDIS mengatur anggota RevisiHeader ke nilai berikut:

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1.

Flags

Nilai ULONG yang berisi bitwise ATAU dari bendera berikut:

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION

Bendera ini menentukan untuk menghitung VPort yang terpasang pada fungsi PCI Express (PCIe) tertentu. Fungsi ditentukan dalam anggota AttachedFunctionId . Bendera ini dapat digunakan untuk menghitung VPort yang terpasang pada PCIe Physical Function (PF) atau PCIe Virtual Function (VF) tertentu.

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Bendera ini menentukan untuk menghitung VPort yang dibuat pada sakelar tertentu, yang ditentukan oleh SwitchId. Ini menghitung semua VPort yang dibuat pada sakelar.

Catatan Bendera ini saling eksklusif. Hanya satu bendera yang dapat diatur di anggota Bendera .

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.

Anggota SwitchId hanya valid jika NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH ditentukan dalam anggota Bendera .

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.

AttachedFunctionId

Nilai NDIS_SRIOV_FUNCTION_ID yang menentukan pengidentifikasi PF atau VF pada adaptor jaringan.

Catatan Jika nilai ini NDIS_PF_FUNCTION_ID, VPort dilampirkan ke PF.

Anggota AttachedFunctionId hanya valid jika NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION ditentukan dalam anggota Bendera .

FirstElementOffset

Nilai ULONG yang menentukan offset, dalam byte, ke elemen pertama dalam array elemen yang mengikuti struktur ini. Offset diukur dari awal struktur NDIS_NIC_SWITCH_VPORT_INFO_ARRAY hingga awal elemen pertama. Setiap elemen dalam array adalah struktur NDIS_NIC_SWITCH_VPORT_INFO .

Catatan Jika NumElements diatur ke nol, anggota ini diabaikan.

NumElements

Nilai ULONG yang menentukan jumlah elemen yang mengikuti struktur NDIS_NIC_SWITCH_VPORT_INFO_ARRAY .

ElementSize

Nilai ULONG yang menentukan ukuran, dalam byte, dari setiap elemen yang mengikuti struktur NDIS_NIC_SWITCH_VPORT_INFO_ARRAY .

Keterangan

NDIS mengembalikan struktur NDIS_NIC_SWITCH_VPORT_INFO_ARRAY saat NDIS menangani permintaan metode OID OID_NIC_SWITCH_ENUM_VPORTS. Setiap elemen dalam array yang mengikuti struktur NDIS_NIC_SWITCH_VPORT_INFO_ARRAY adalah
NDIS_NIC_SWITCH_VPORT_INFO struktur.

Untuk informasi selengkapnya tentang antarmuka SR-IOV, lihat Gambaran Umum Virtualisasi I/O Akar 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_VPORT_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VPORTS

Share via