struktur NDIS_NIC_SWITCH_VF_INFO_ARRAY (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_NIC_SWITCH_VF_INFO_ARRAY menentukan array. Setiap elemen dalam array menentukan atribut fungsi virtual (VF) PCI Express (PCIe) yang telah diaktifkan dan dialokasikan pada adaptor jaringan.

Sintaks

typedef struct _NDIS_NIC_SWITCH_VF_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  NDIS_NIC_SWITCH_ID SwitchId;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_VF_INFO_ARRAY, *PNDIS_NIC_SWITCH_VF_INFO_ARRAY;

Anggota

Header

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

NDIS mengatur jenis anggotaHeader ke NDIS_OBJECT_TYPE_DEFAULT. Untuk menentukan versi struktur NDIS_NIC_SWITCH_VF_INFO_ARRAY , NDIS mengatur anggota RevisiHeader ke nilai berikut:

NDIS_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1.

Flags

Nilai ULONG yang berisi bitwise ATAU dari bendera berikut:

NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

Jika bendera ini diatur, driver miniport hanya boleh mengembalikan array struktur NDIS_NIC_SWITCH_VF_INFO untuk VF yang telah dialokasikan pada sakelar adaptor jaringan yang ditentukan oleh anggota SwitchId . Untuk informasi lebih lanjut, lihat bagian Keterangan.

Jika anggota Bendera diatur ke nol, driver miniport harus mengembalikan array struktur NDIS_NIC_SWITCH_VF_INFO untuk setiap VF yang telah dialokasikan pada setiap sakelar adaptor jaringan adaptor jaringan.

Catatan Dimulai dengan Windows Server 2012, antarmuka SR-IOV hanya mendukung sakelar adaptor jaringan default pada adaptor jaringan. Oleh karena itu, driver miniport hanya boleh mengembalikan array struktur NDIS_NIC_SWITCH_VF_INFO untuk setiap VF yang telah dialokasikan pada sakelar adaptor jaringan default.

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 SR-IOV hanya mendukung sakelar adaptor jaringan default yang dibuat pada adaptor jaringan. Oleh karena itu, anggota ini harus selalu diatur ke NDIS_DEFAULT_SWITCH_ID.

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_VF_INFO_ARRAY hingga awal elemen pertama. Setiap elemen dalam array adalah struktur NDIS_NIC_SWITCH_VF_INFO .

Catatan Jika NumElements diatur ke nol, anggota ini diabaikan.

NumElements

Nilai ULONG yang menentukan jumlah elemen yang mengikuti struktur NDIS_NIC_SWITCH_VF_INFO_ARRAY .

ElementSize

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

Keterangan

NDIS mengembalikan struktur NDIS_NIC_SWITCH_VF_INFO_ARRAY saat menangani permintaan metode OID OID_NIC_SWITCH_ENUM_VFS. Setiap elemen dalam array yang mengikuti struktur NDIS_NIC_SWITCH_VF_INFO_ARRAY adalah
NDIS_NIC_SWITCH_VF_INFO struktur.

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_VF_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VFS

Share via