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) |