structure NDIS_CONFIGURATION_PARAMETER (ndis.h)
La structure NDIS_CONFIGURATION_PARAMETER contient les données et le type d’une entrée nommée dans le Registre.
Syntaxe
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;
Membres
ParameterType
Type du paramètre spécifié comme l’une des valeurs d’énumération NDIS_PARAMETER_TYPE .
Pour les appels réussis à la fonction NdisReadConfiguration , le
La valeur ParameterType correspond à la valeur du paramètre ParameterType . Toutefois, lorsque le paramètre ParameterType est NdisParameterHexInteger, la valeur du membre ParameterType résultante est NdisParameterInteger.
ParameterData
Union qui contient la valeur de l’entrée nommée donnée. Si ParameterType est un type de chaîne, ce membre est un type NDIS_STRING décrivant une chaîne comptée dans le jeu de caractères par défaut du système. Pour les pilotes Microsoft Windows 2000 et versions ultérieures, une telle chaîne contient des caractères Unicode. Autrement dit, pour Windows 2000 et versions ultérieures, NDIS définit le type NDIS_STRING comme un type UNICODE_STRING .
Cette union contient les membres suivants :
ParameterData.IntegerData
Valeur ULONG utilisée lorsque le membre ParameterType est défini sur NdisParameterInteger ou NdisParameterHexInteger.
ParameterData.StringData
Valeur NDIS_STRING utilisée lorsque le membre ParameterType est défini sur NdisParameterString ou NdisParameterMultiString.
ParameterData.BinaryData
Une structure BINARY_DATA utilisée lorsque le membre ParameterType est défini sur NdisParameterBinary.
Remarques
Pour lire les paramètres dans le Registre, un pilote NDIS peut appeler la fonction NdisReadConfiguration . Si l’appel réussit, NDIS retourne un pointeur vers une structure NDIS_CONFIGURATION_PARAMETER au niveau du paramètre ParameterValue de NdisReadConfiguration.
Pour écrire des paramètres dans le Registre, un pilote NDIS peut appeler la fonction NdisWriteConfiguration . Dans ce cas, le pilote initialise une structure NDIS_CONFIGURATION_PARAMETER et la transmet au paramètre ParameterValue de NdisWriteConfiguration.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 dans Windows XP. |
| En-tête | ndis.h (inclure Ndis.h) |