struktur NDIS_CONFIGURATION_PARAMETER (ndis.h)

Struktur NDIS_CONFIGURATION_PARAMETER berisi data dan jenis entri bernama dalam registri.

Sintaks

typedef struct _NDIS_CONFIGURATION_PARAMETER {
  NDIS_PARAMETER_TYPE ParameterType;
  union {
    ULONG       IntegerData;
    NDIS_STRING StringData;
    BINARY_DATA BinaryData;
  } ParameterData;
} NDIS_CONFIGURATION_PARAMETER, *PNDIS_CONFIGURATION_PARAMETER;

Anggota

ParameterType

Jenis parameter yang ditentukan sebagai salah satu nilai enumerasi NDIS_PARAMETER_TYPE .

Untuk panggilan yang berhasil ke fungsi NdisReadConfiguration ,
Nilai ParameterType cocok dengan nilai pada parameter ParameterType . Namun, ketika parameter ParameterType adalah NdisParameterHexInteger, nilai anggota ParameterType yang dihasilkan adalah NdisParameterInteger.

ParameterData

Serikat yang berisi nilai entri bernama yang diberikan. Jika ParameterType adalah jenis string, anggota ini adalah jenis NDIS_STRING yang menjelaskan string yang dihitung dalam kumpulan karakter default sistem. Untuk driver Microsoft Windows 2000 dan yang lebih baru, string tersebut berisi karakter Unicode. Artinya, untuk Windows 2000 dan yang lebih baru, NDIS mendefinisikan jenis NDIS_STRING sebagai jenis UNICODE_STRING .

Serikat ini berisi anggota berikut:

ParameterData.IntegerData

Nilai ULONG yang digunakan saat anggota ParameterType diatur ke NdisParameterInteger atau NdisParameterHexInteger.

ParameterData.StringData

Nilai NDIS_STRING yang digunakan saat anggota ParameterType diatur ke NdisParameterString atau NdisParameterMultiString.

ParameterData.BinaryData

Struktur BINARY_DATA yang digunakan saat anggota ParameterType diatur ke NdisParameterBinary.

Keterangan

Untuk membaca parameter dalam registri, driver NDIS dapat memanggil fungsi NdisReadConfiguration . Jika panggilan berhasil, NDIS mengembalikan penunjuk ke struktur NDIS_CONFIGURATION_PARAMETER pada parameter ParameterValueNdisReadConfiguration.

Untuk menulis parameter ke registri, driver NDIS dapat memanggil fungsi NdisWriteConfiguration . Dalam hal ini, driver menginisialisasi struktur NDIS_CONFIGURATION_PARAMETER dan meneruskannya pada parameter ParameterValuedari NdisWriteConfiguration.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver NDIS 6.0 dan NDIS 5.1 di Windows Vista. Didukung untuk driver NDIS 5.1 di Windows XP.
Header	ndis.h (termasuk Ndis.h)

Lihat juga

BINARY_DATA

NDIS_PARAMETER_TYPE

NdisReadConfiguration

NdisWriteConfiguration

UNICODE_STRING