NPAB_Get_Instance_Number

Retrieves the instance number of the specified device or function on the specified bus.

Thread Context:Non-Blocking

Syntax

    LONG NPAB_Get_Instance_Number (
       LONG   npaHandle,
       LONG   busTag,
       LONG   uniqueID,
       WORD  *instanceNumber
    );

Parameters

npaHandle
(IN) The HAM's handle for using the NPA APIs, assigned during NPA_Register_HAM_Module.
busTag
(IN) An architecture-dependent value returned by NPAB_Search_Adapter or by parsing the Product ID option of the NPAOptionStruct. This value specifies the bus on which the operation is to be performed.
uniqueID
An architecture-dependent value returned by NPAB_Search_Adapter, NPAB_Get_Instance_Number_Mapping, or NPAB_Get_Unique_Identifier that uniquely identifies a specific device or function.
instanceNumber
(OUT) Receives the instance number for the specified busTag and uniqueID. This value is unique for all buses on the system.

Return Values

The following table lists return values and descriptions.

0

Successful

4

One or more of the parameters passed was incorrect.

Remarks

There is a one-to-one correspondence between bus tag and unique identifier pairs and instance numbers. An instance number can be thought of as a logical slot number. If an adapter contains just one function, the instance number is equivalent to the adapter's physical slot number. Instance numbers are unique across all buses and devices on the system. They are generated or determined by NetWare and are consistent across system boots.