NPAB_Get_Instance_Number_Mapping

Retrieves the bus tag and unique identifier associated with the instance number specified.

Thread Context:Non-Blocking

Syntax

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

Parameters

npaHandle
(IN) The HAM's handle for using the NPA APIs, assigned during NPA_Register_HAM_Module.
instanceNumber
(IN) The instance number of the device or function.
busTag
(OUT) Receives the bus tag for the selected instance number.
uniqueID
(OUT) Receives the unique identifier for the selected instance number.

Return Values

The following table lists return values and descriptions.

0

Successful

3

A memory error occurred.

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.