9.1.9 Query Parameter Ranging

NcDetectParamRange accepts a NIC ID number and a pointer to the name of a parameter. It returns its results in an array of LONGs (plValues), along with a highest subscript for the given parameter. The function prototype is as follows:

LONG NcDetectParamRange(
LONG   lNetcardId,
WCHAR   *pwchParam,
LONG   *plValues,
LONG   *plValueCount
);

Parameters

lNetcardId

Specifies the index for the NIC obtained by the calling function through NcDetectIdentify. This value is always an integral of 100, starting with 1000.

pwchParam

Points to a buffered Unicode string naming the parameter.

plValues

Points to a buffer in which the values for the given parameter are returned.

plValueCount

On entry to the function, the plValueCount parameter indicates the capacity of the buffer, in units of LONGs (buffer size / 4). On exit, the function sets the parameter to the highest value used, plus one (limit of resulting plValues array).

Comments

For example, the IRQ parameter of the Ungermann-Bass EOTP card might return the following in the buffer at plValues:

{2.3,5,7.12}