struktur NDIS_SWITCH_PORT_PROPERTY_PARAMETERS (ntddndis.h)

Artikel
03/08/2023

Struktur NDIS_SWITCH_PORT_PROPERTY_PARAMETERS menentukan parameter untuk properti kebijakan dari port sakelar hyper-V yang dapat diperluas.

Sintaks

typedef struct _NDIS_SWITCH_PORT_PROPERTY_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_VERSION               PropertyVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           PropertyInstanceId;
  ULONG                                    PropertyBufferLength;
  ULONG                                    PropertyBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_PROPERTY_PARAMETERS, *PNDIS_SWITCH_PORT_PROPERTY_PARAMETERS;

Anggota

Header

Jenis, revisi, dan ukuran struktur NDIS_SWITCH_PORT_PROPERTY_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_PARAMETERS , anggota RevisiHeader harus diatur ke nilai berikut:

NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_SWITCH_PORT_PROPERTY_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 tempat properti ditetapkan.

PropertyType

Nilai enumerasi NDIS_SWITCH_PORT_PROPERTY_TYPE yang menentukan jenis properti port yang terkandung dalam buffer properti.

PropertyId

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

Untuk informasi lebih lanjut, lihat bagian Keterangan.

Catatan Ekstensi sakelar yang dapat diperluas harus mengabaikan anggota ini kecuali anggota PropertyType diatur ke NdisSwitchPortPropertyTypeCustom.

PropertyVersion

Nilai NDIS_SWITCH_OBJECT_VERSION yang mengidentifikasi versi 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.

PropertyInstanceId

Nilai NDIS_SWITCH_OBJECT_INSTANCE_ID yang mengidentifikasi instans properti untuk port sakelar yang dapat diperluas.

PropertyBufferLength

Nilai ULONG yang menentukan ukuran, dalam byte, dari buffer properti.

PropertyBufferOffset

Nilai ULONG yang menentukan offset, dalam byte, ke buffer properti yang mengikuti struktur NDIS_SWITCH_PORT_PROPERTY_PARAMETERS . Offset diukur dari awal struktur NDIS_SWITCH_PORT_PROPERTY_PARAMETERS hingga awal buffer properti.

Reserved

Disiapkan untuk penggunaan masa mendatang.

Keterangan

Struktur NDIS_SWITCH_PORT_PROPERTY_PARAMETERS digunakan dalam permintaan set OID berikut:

Buffer properti berisi struktur yang terkait dengan anggota PropertyType . Buffer properti mengikuti struktur NDIS_SWITCH_PORT_PROPERTY_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 harus mengikuti panduan ini saat memproses struktur NDIS_SWITCH_PORT_PROPERTY_PARAMETERS :

Jika anggota PropertyType diatur ke NdisSwitchPortPropertyTypeSecurity, buffer properti diformat sebagai struktur NDIS_SWITCH_PORT_PROPERTY_SECURITY .
Jika anggota PropertyType diatur ke NdisSwitchPortPropertyTypeVlan, buffer properti diformat sebagai struktur NDIS_SWITCH_PORT_PROPERTY_VLAN .
Jika anggota PropertyType diatur ke NdisSwitchPortPropertyTypeProfile, buffer properti diformat sebagai struktur NDIS_SWITCH_PORT_PROPERTY_PROFILE .
Jika anggota PropertyType diatur ke NdisSwitchPortPropertyTypeCustom, anggota PropertyId harus diatur ke nilai GUID vendor perangkat lunak independen (ISV) yang dibuat untuk properti port kustom. Buffer properti diformat sebagai struktur NDIS_SWITCH_PORT_PROPERTY_CUSTOM yang berisi parameter untuk properti port kustom seperti yang didefinisikan oleh ISV.

Ekstensi sakelar yang dapat diperluas dapat mengakses properti port kustom di dalam struktur NDIS_SWITCH_PORT_PROPERTY_PARAMETERS dengan menggunakan makro NDIS_SWITCH_PORT_PROPERTY_PARAMETERS_GET_PROPERTY .

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