NDIS_CONFIGURATION_PARAMETER (Windows Embedded CE 6.0)

1/6/2010

This structure describes the configuration parameters for a NIC.

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 following table shows the types of value entry for ParameterType.

  Value Entry	Description
  NdisParameterInteger	Specifies an integer in decimal notation.
  NdisParameterHexInteger	Specifies an integer in hexadecimal notation.
  NdisParameterString	Specifies a string of type NDIS_STRING. For Windows drivers, this is a counted Unicode string.
  NdisParameterMultiString	Specifies a multistring parameter of the REG_MULTI_SZ type.

• IntegerData
  Specifies the value of the integer data entry.

• StringData
  Specifies the value of the string data entry.

• BinaryData
  Specifies the value of the binary data entry.

• ParameterData
  Specifies the value of the given named entry. If ParameterType is a string type, this member is an NDIS_STRING type describing a counted string in the system-default character set.

Remarks

Every NDIS driver can set up configuration information in the registry for itself under the driver's Parameters key using an installation script. For example, a protocol driver might store its own name as an entry with a preformatted string value that can be passed in calls to NdisRegisterProtocol.

Each NIC driver also has associated value entries under the driver's Parameters registry key. The value entries for any particular NIC driver can be device-dependent in nature. For example, an Ethernet NIC driver might have keywords such as InterruptNumber, SharedMemoryAddress, and MulticastListSize. The value associated with such an NDIS keyword can be either an integer (ULONG-type) or an NDIS_STRING type. For example, the set of possible values for the already mentioned InterruptNumber entry might be NdisParameterInteger values 2, 3, 4, or 5, or the equivalents in hexadecimal as NdisParameterHexInteger values.

Requirements

See Also

Reference

NDIS Structures
NdisReadConfiguration
NdisRegisterProtocol
NdisWriteConfiguration
NDIS_PARAMETER_TYPE