struktur NDIS_SWITCH_PROPERTY_CUSTOM (ntddndis.h)

Artikel
02/29/2024

Struktur NDIS_SWITCH_PROPERTY_CUSTOM menentukan properti profil kustom untuk sakelar Hyper-V yang dapat diperluas.

Vendor perangkat lunak independen (ISV) menentukan format untuk properti kustom. Format properti kustom adalah milik ISV.

Sintaks

typedef struct _NDIS_SWITCH_PROPERTY_CUSTOM {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              PropertyBufferLength;
  ULONG              PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_CUSTOM, *PNDIS_SWITCH_PROPERTY_CUSTOM;

Anggota

Header

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

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

NDIS_SWITCH_PROPERTY_CUSTOM_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_CUSTOM_REVISION_1.

Flags

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

PropertyBufferLength

Nilai ULONG yang menentukan ukuran, dalam byte, dari buffer yang berisi properti sakelar yang dapat diperluas kustom.

PropertyBufferOffset

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

Keterangan

Struktur NDIS_SWITCH_PROPERTY_CUSTOM digunakan dalam permintaan set OID berikut:

Struktur NDIS_SWITCH_PROPERTY_CUSTOM mengikuti struktur NDIS_SWITCH_PROPERTY_PARAMETERS dalam buffer yang terkait dengan permintaan set OID ini. Anggota InformationBuffer dari struktur NDIS_OID_REQUEST berisi penunjuk ke buffer ini.

Ekstensi sakelar yang dapat diperluas dapat mengakses buffer properti sakelar kustom yang ditentukan oleh struktur NDIS_SWITCH_PROPERTY_CUSTOM dengan menggunakan makro NDIS_SWITCH_PROPERTY_CUSTOM_GET_BUFFER .

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