structure NDIS_CONFIGURATION_PARAMETER (configurationparameter.h)

La structure NDIS_CONFIGURATION_PARAMETER contient les données et le type d’une entrée nommée dans le Registre.

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;

Members

ParameterType

The type of the parameter specified as one of the NDIS_PARAMETER_TYPE enumeration values.

For successful calls to the NdisReadConfiguration function, the
ParameterType value matches the value at the ParameterType parameter. However, when the ParameterType parameter is NdisParameterHexInteger, the resulting ParameterType member value is 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 système. Pour les pilotes Microsoft Windows 2000 et versions ultérieures, une telle chaîne contient des caractères Unicode. That is, for Windows 2000 and later, NDIS defines the NDIS_STRING type as a UNICODE_STRING type.

Cette union contient les membres suivants :

ParameterData.IntegerData

A ULONG value that is used when the ParameterType member is set to NdisParameterInteger or NdisParameterHexInteger.

ParameterData.StringData

An NDIS_STRING value that is used when the ParameterType member is set to NdisParameterString or NdisParameterMultiString.

ParameterData.BinaryData

A BINARY_DATA structure that is used when the ParameterType member is set to NdisParameterBinary.

Remarks

To read parameters in the registry, an NDIS driver can call the NdisReadConfiguration function. If the call is successful, NDIS returns a pointer to an NDIS_CONFIGURATION_PARAMETER structure at the ParameterValue parameter of NdisReadConfiguration.

To write parameters to the registry, an NDIS driver can call the NdisWriteConfiguration function. In this case, the driver initializes an NDIS_CONFIGURATION_PARAMETER structure and passes it at the ParameterValue parameter of NdisWriteConfiguration.

Requirements

See also

BINARY_DATA

NDIS_PARAMETER_TYPE

NdisReadConfiguration

NdisWriteConfiguration

UNICODE_STRING