struktur NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS menentukan parameter untuk informasi status kustom port sakelar hyper-V yang dapat diperluas. Informasi ini dikenal sebagai informasi status fitur . Format informasi ini ditentukan oleh vendor perangkat lunak independen (ISV).

Informasi status ditentukan melalui struktur NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM dan dikembalikan melalui permintaan metode OID OID_SWITCH_PORT_FEATURE_STATUS_QUERY.

Sintaks

typedef struct _NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_PORT_ID                      PortId;
  NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE     FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  ULONG                                    FeatureStatusBufferLength;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    Reserved;
} NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS;

Anggota

Header

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

NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS_REVISION_1.

Flags

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

PortId

Nilai NDIS_SWITCH_PORT_ID yang menentukan pengidentifikasi numerik untuk port sakelar yang dapat diperluas. Nilai ini secara unik mengidentifikasi port pada sakelar yang dapat diperluas yang informasi status fiturnya akan dikembalikan.

FeatureStatusType

Nilai enumerasi NDIS_SWITCH_PORT_FEATURE_STATUS_TYPE yang menentukan jenis informasi status untuk properti profil port sakelar yang dapat diperluas kustom.

Catatan Dimulai dengan NDIS 6.30, anggota ini harus diatur ke NdisSwitchPortPropertyTypeCustom.

FeatureStatusId

Nilai NDIS_SWITCH_OBJECT_ID yang mengidentifikasi properti profil untuk port sakelar yang dapat diperluas.

FeatureStatusVersion

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

FeatureStatusInstanceId

Nilai NDIS_SWITCH_OBJECT_INSTANCE_ID yang mengidentifikasi instans informasi status fitur untuk port sakelar yang dapat diperluas.

FeatureStatusBufferLength

Nilai ULONG yang menentukan ukuran, dalam byte, dari buffer status fitur.

FeatureStatusBufferOffset

Nilai ULONG yang menentukan offset, dalam byte, ke buffer status fitur yang mengikuti struktur NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS . Buffer status fitur berisi struktur NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM .

Offset diukur dari awal struktur NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS hingga awal struktur NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM .

Reserved

Disiapkan untuk penggunaan masa mendatang.

Keterangan

Struktur NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS digunakan dalam permintaan metode OID OID_SWITCH_PORT_FEATURE_STATUS_QUERY. Permintaan OID ini mengembalikan struktur berikut dalam buffer informasi yang terkait dengan permintaan OID:

Struktur NDIS_SWITCH_PORT_FEATURE_STATUS_PARAMETERS yang menentukan parameter untuk properti kustom dari port sakelar yang dapat diperluas yang informasi statusnya akan dikembalikan. Ekstensi switch mengisi anggota FeatureStatusVersion dari struktur untuk mencerminkan versi status kustom yang dikembalikan dalam buffer NDIS_SWITCH_FEATURE_STATUS_CUSTOM. Sakelar Hyper-v Extensible mengisi semua anggota lain saat mengeluarkan OID kueri.
Struktur NDIS_SWITCH_PORT_FEATURE_STATUS_CUSTOM yang berisi informasi status untuk properti port sakelar yang dapat diperluas. Ekstensi sakelar mengisi anggota struktur FeatureStatusCustomBufferLength untuk mencerminkan ukuran status kustom yang dikembalikan. Sakelar Hyper-v Extensible mengisi semua anggota lain saat mengeluarkan OID kueri.