9.1.7 Query Configuration

NcDetectQueryCfg checks the current configuration of a NIC. The function prototype is as follows:

LONG NcDetectQueryCfg(
PVOID pvHandle,
WCHAR   *pwchBuffer,
LONG   cwchBuffSize
);

Parameters

ppvHandle

Points to the handle returned by a successful call to NcDetectOpenHandle.

pwchBuffer

Specifies the base virtual address of a buffer in which this function returns the data.

cwchBuffSize

Specifies the size in bytes of the buffer.

Comments

Configuration parameter values are output in the given buffer as pairs of strings, each delimited by a (nul) string. For example:

IRQ(nul)0x310(nul)IOADDR(nul)0x368(nul)MEMADDR(nul)0xD8000
(nul)(nul)
 

The values occur in pairs, with the value item name displaying first and the currently detected setting appearing second. This format implies that the names of certain common parameters are clearly defined by this interface, such as the following:

• IRQ

• IOADDR

• IOADDRLENGTH

• MEMADDR

• MEMADDRLENGTH

• TRANSCEIVER

For more information about these names, see Section 9.13.

A DLL and its .inf file or installer program can use any other values for reporting and setting configuration information. However, all such privately defined values must begin with a dollar sign ($).

Standard C language numeric literal conventions are used for all numbers. They are assumed to be decimal unless prefixed with 0x. All string values are case-insensitive. No ordering of return parameters can be assumed.

If no value for a particular parameter is detected, that parameter should not appear in the result buffer.