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)

Voir aussi

BINARY_DATA

NDIS_PARAMETER_TYPE

NdisReadConfiguration

NdisWriteConfiguration

UNICODE_STRING