struktur NDIS_SWITCH_PROPERTY_ENUM_INFO (ntddndis.h)

Artikel
08/07/2023

Struktur NDIS_SWITCH_PROPERTY_ENUM_INFO menentukan informasi tentang properti profil untuk sakelar Hyper-V yang dapat diperluas.

Sintaks

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_INFO {
  NDIS_OBJECT_HEADER             Header;
  ULONG                          Flags;
  NDIS_SWITCH_OBJECT_INSTANCE_ID PropertyInstanceId;
  NDIS_SWITCH_OBJECT_VERSION     PropertyVersion;
  ULONG                          QwordAlignedPropertyBufferLength;
  ULONG                          PropertyBufferLength;
  ULONG                          PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_ENUM_INFO, *PNDIS_SWITCH_PROPERTY_ENUM_INFO;

Anggota

Header

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

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

NDIS_SWITCH_PROPERTY_ENUM_INFO_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1.

Flags

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

PropertyInstanceId

Nilai NDIS_SWITCH_OBJECT_INSTANCE_ID yang menentukan pengidentifikasi instans properti sakelar yang dapat diperluas.

PropertyVersion

Nilai NDIS_SWITCH_OBJECT_VERSION yang mengidentifikasi versi properti untuk port sakelar yang dapat diperluas.

QwordAlignedPropertyBufferLength

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

PropertyBufferLength

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

Catatan Nilai ini harus kurang dari atau sama dengan nilai anggota QwordAlignedPropertyBufferLength .

PropertyBufferOffset

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

Keterangan

Struktur NDIS_SWITCH_PROPERTY_ENUM_INFO digunakan dalam permintaan set OID_SWITCH_PROPERTY_ENUM OID. Array struktur NDIS_SWITCH_PROPERTY_ENUM_INFO mengikuti struktur NDIS_SWITCH_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 elemen NDIS_SWITCH_PROPERTY_ENUM_INFO berikutnya yang mengikuti struktur NDIS_SWITCH_PROPERTY_ENUM_INFO dalam array dengan menggunakan makro NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_NEXT .

Ekstensi sakelar yang dapat diperluas dapat mengakses buffer properti sakelar yang dapat diperluas yang ditentukan oleh struktur NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO dengan menggunakan makro NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_PROPERTY .

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