Keywords That Can Be Edited

NDIS 6.0 and later versions of NDIS provide standardized keywords that can be edited for miniport drivers of network devices. These standardized keywords are associated with numeric or text values that you can edit in the user interface.

The following example shows an INF file definition for a keyword that can be edited.


HKR, Ndi\params\<SubkeyName>,ParamDesc, 0, "<ParamDesc>"
HKR, Ndi\params\<SubkeyName>,Type, 0, "int"
HKR, Ndi\params\<SubkeyName>,Default, 0, "<IHV defined>"
HKR, Ndi\params\<SubkeyName>,Optional, 0, "0"
HKR, Ndi\params\<SubkeyName>,Min, 0, "0"
HKR, Ndi\params\<SubkeyName>,Max, 0, "<IHV defined>"

The standard keywords that can be edited are:

*JumboPacket

The size, in bytes, of the largest supported Jumbo Packet (an Ethernet frame that is greater than 1514 bytes) that the hardware can support. This is also known as a Jumbo Frame.

*ReceiveBuffers

The number of receive descriptors used by the miniport adapter. The miniport driver can choose any default value that is appropriate for performance-tuning. Note that if the value is too small, the miniport adapter may run out of receive buffers under heavy load. If the value is too large, system resources are wasted.

*TransmitBuffers

The size, in bytes, of the transmit buffers that the hardware can support. This size is hardware-dependent and can include data buffers, buffer descriptors, and so on. Hardware vendors can assign any value that is appropriate for their purposes.

NetworkAddress

The network address of the device. The format for a MAC address is: XX-XX-XX-XX-XX-XX. The hyphens (-) are optional.

The columns in the table at the end of this topic describe the following attributes for keywords that can be edited:

SubkeyName

The name of the keyword that you must specify in the INF file and that appears in the registry.

ParamDesc

The display text that is associated with SubkeyName.

Type

The type of value that can be edited. The value can be either numeric (Int) or text that can be edited (Edit).

Default value

The default value for the integer or text. <IHV defined> indicates that the value is associated with the particular independent hardware vendor (IHV) requirements.

Min

The minimum value that is allowed for an integer. <IHV defined> indicates that the minimum value is associated with the particular IHV requirements.

Max

The maximum value that is allowed for an integer. <IHV defined> indicates that the minimum value is associated with the particular IHV requirements.

The following table lists all of the keywords and describes the values that a driver must use for the preceding attributes. For more information about a keyword, search for the keyword in the WDK documentation.

SubkeyNameParamDescTypeDefault valueMinMax

*JumboPacket

Jumbo Packet

Int

1514

1514

<IHV defined>

*ReceiveBuffers

Receive Buffers

Int

<IHV defined>

1

<IHV defined>

*TransmitBuffers

Transmit Buffers

Int

<IHV defined>

0

<IHV defined>

NetworkAddress

Network Address

Edit

N/A

N/A

N/A

 

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft