NDIS_CONFIGURATION_PARAMETER-Struktur (ndis.h)

Die NDIS_CONFIGURATION_PARAMETER-Struktur enthält die Daten und den Typ eines benannten Eintrags in der Registrierung.

Syntax

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;

Member

ParameterType

Der Typ des Parameters, der als einer der NDIS_PARAMETER_TYPE Enumerationswerte angegeben ist.

Bei erfolgreichen Aufrufen der NdisReadConfiguration-Funktion
Der ParameterType-Wert stimmt mit dem Wert am ParameterType-Parameter überein. Wenn der ParameterType-Parameter jedoch NdisParameterHexInteger ist, ist der resultierende ParameterType-MemberwertNdisParameterInteger.

ParameterData

Eine Union, die den Wert des angegebenen benannten Eintrags enthält. Wenn ParameterType ein Zeichenfolgentyp ist, ist dieser Member ein NDIS_STRING Typ, der eine gezählte Zeichenfolge im Systemstandardzeichensatz beschreibt. Bei Treibern von Microsoft Windows 2000 und höher enthält eine solche Zeichenfolge Unicode-Zeichen. Das heißt, für Windows 2000 und höher definiert NDIS den NDIS_STRING-Typ als UNICODE_STRING-Typ .

Diese Union enthält die folgenden Elemente:

ParameterData.IntegerData

Ein ULONG-Wert, der verwendet wird, wenn das ParameterType-Element auf NdisParameterInteger oder NdisParameterHexInteger festgelegt ist.

ParameterData.StringData

Ein NDIS_STRING Wert, der verwendet wird, wenn das ParameterType-Element auf NdisParameterString oder NdisParameterMultiString festgelegt ist.

ParameterData.BinaryData

Eine BINARY_DATA-Struktur , die verwendet wird, wenn das ParameterType-Element auf NdisParameterBinary festgelegt ist.

Hinweise

Zum Lesen von Parametern in der Registrierung kann ein NDIS-Treiber die NdisReadConfiguration-Funktion aufrufen. Wenn der Aufruf erfolgreich ist, gibt NDIS einen Zeiger auf eine NDIS_CONFIGURATION_PARAMETER-Struktur am ParameterValue-Parameter von NdisReadConfiguration zurück.

Um Parameter in die Registrierung zu schreiben, kann ein NDIS-Treiber die NdisWriteConfiguration-Funktion aufrufen. In diesem Fall initialisiert der Treiber eine NDIS_CONFIGURATION_PARAMETER-Struktur und übergibt sie am ParameterValue-Parameter von NdisWriteConfiguration.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber in Windows Vista. Unterstützt für NDIS 5.1-Treiber in Windows XP.
Kopfzeile	ndis.h (einschließlich Ndis.h)

Weitere Informationen

BINARY_DATA

NDIS_PARAMETER_TYPE

NdisReadConfiguration

NdisWriteConfiguration

UNICODE_STRING