struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS menentukan array properti kebijakan untuk port sakelar hyper-V yang dapat diperluas. Setiap elemen dalam array diformat sebagai struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO .

Sintaks

typedef struct _NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_PROPERTY_TYPE           PropertyType;
  NDIS_SWITCH_OBJECT_ID                    PropertyId;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FirstPropertyOffset;
  ULONG                                    NumProperties;
  USHORT                                   Reserved;
} NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS;

Anggota

Header

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

Anggota JenisHeader harus diatur ke NDIS_OBJECT_TYPE_DEFAULT. Untuk menentukan versi struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS , anggota RevisiHeader harus diatur ke nilai berikut:

NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_REVISION_1.

Flags

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

PortId

Nilai NDIS_SWITCH_PORT_ID yang berisi pengidentifikasi unik port sakelar yang dapat diperluas yang propertinya dijumlahkan.

PropertyType

Nilai enumerasi NDIS_SWITCH_PORT_PROPERTY_TYPE yang menentukan jenis properti port. Ketika permintaan metode OID OID_SWITCH_PORT_PROPERTY_ENUM dikeluarkan, ekstensi sakelar yang dapat diperluas mengembalikan properti port yang cocok dengan jenis properti ini.

PropertyId

Nilai GUID yang mengidentifikasi properti untuk port sakelar yang dapat diperluas.

SerializationVersion

Nilai NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION yang mengidentifikasi versi format data properti port yang diserialisasikan. Data ini diserialisasikan untuk akses oleh ekstensi dari file Managed Object Format (MOF) yang menentukan properti .

Catatan Untuk Windows Server 2012, anggota SerializationVersion harus diatur ke NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1.

FirstPropertyOffset

Nilai USHORT yang menentukan offset, dalam byte, ke elemen NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO pertama yang mengikuti struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS . Offset diukur dari awal struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS hingga awal elemen pertama array.

Catatan Jika nilai NumProperties adalah nol, anggota ini diabaikan.

NumProperties

Nilai ULONG yang menentukan jumlah elemen NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO yang mengikuti struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS .

Reserved

Disiapkan untuk penggunaan masa mendatang.

Keterangan

Struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS digunakan dalam permintaan metode OID OID_SWITCH_PORT_PROPERTY_ENUM. Array struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO mengikuti struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS dalam buffer informasi yang terkait dengan permintaan set OID ini. Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke buffer informasi ini.

Ekstensi sakelar yang dapat diperluas dapat mengakses struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO pertama yang ditentukan oleh struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS dengan menggunakan makro NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS_GET_FIRST_INFO .

Untuk informasi selengkapnya tentang kebijakan sakelar yang dapat diperluas, lihat Kebijakan Sakelar yang Dapat Diperluas Hyper-V.