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.