9.1.2  Query Configuration Parameters

NcDetectQueryMask returns a buffer of Unicode strings, each of which is delimited by a Unicode NUL and is specified as (NUL), a zero-length string. The end of the buffer is indicated by an additional NUL. The function prototype is:

LONG NcDetectQueryMask(
LONG   lNetcardId,
WCHAR   *pwchBuffer,
LONG   cwchBuffSize
);

The Unicode strings are grouped into sets of three. In order of arrangement, group elements are as follows:

1.The internal name of the parameter. This name must not contain special characters or blanks.

2.One of the following values:

Zero

Parameter cannot be set using software.

One

Parameter can be set using software.

Two

Parameter cannot be set using software and is not normally displayed to users.

3.A number from 0 to 100 indicating the confidence the detection DLL has in detecting the setting of the given parameter. A setting of 100 implies complete confidence.

Comments

For example, using the string (nul) to represent a binary zero character would appear as follows:

IRQ(nul)1(nul)70(nul)
IOADDR(nul)0(nul)0(nul)
MEMADDR(nul)0(nul)0(nul)
MEMADDRLENGTH(nul)2(nul)100(nul)
(nul)

This buffer defines four parameter names:  IRQ, IOADDR, MEMADDR, and MEMADDRLENGTH. Pointers to these strings are used as parameters of other functions.