NPAB_Get_Unique_Identifier_Parameters

Returns bus-specific information about the device or function represented by the given unique identifier.

Thread Context:Non-Blocking

Syntax

    LONG NPAB_Get_Unique_Identifier_Parameters (
       LONG   npaHandle,
       LONG   busTag,
       LONG   uniqueID,
       LONG   parameterCount,
       LONG  *parameters
       );

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
(IN) 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.
parameterCount
(IN) The number of elements in the parameter array to be filled in.
parameters
(OUT) An array of LONGs to be filled in with the bus architecture-dependent parameters represented by the specified unique identifier. See NPAB_Get_Unique_Identifier for the format.

Return Values

The following table lists return values and descriptions.

0

Successful

4

One or more of the parameters passed was incorrect.

5

The operation selected is not supported by NBI.

Remarks

NPAB_Get_Unique_Identifier_Parameters is the inverse of NPAB_Get_Unique_Identifier. This function returns bus-specific information for a given unique identifier. The parameters busTag and uniqueID can also be obtained through adding and parsing the Product ID option (see NPAOptionStruct). The Product ID option also returns the instanceNumber (which is the same as slot).