Syntax

    LONG NPAB_Get_Card_Config_Info (
       LONG   npaHandle,
       LONG   busTag,
       LONG   uniqueID,
       LONG   size,
       LONG   parameter0,
       LONG   parameter1,
       void  *configInfo
       );
    
    

Parameters

npaHandle

(IN) The HAM's handle for using the NPA APIs, assigned during NPA_Register_HAM_Module.

busTag

(IN) A 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) A value returned by NPAB_Search_Adapter, NPAB_Get_Instance_Number_Mapping, or NPAB_Get_Unique_Identifier that uniquely identifies a specific device or function.

size

(IN) Specifies the number of bytes to be returned into the configuration buffer. For PCI, at most 0x40 is guaranteed.

parameter0

(IN) Bus architecture-dependent values that further specify what information is to be returned.

parameter1

(IN) Bus architecture-dependent values that further specify what information is to be returned.

configInfo

(OUT) Points to a bus architecture-dependent structure used to receive the returned information. The caller needs to be sure that the buffer is at least size bytes long.

Return Values

The following table lists return values and descriptions.

Remarks

Call NPAB_Get_Card_Config_Info only if the busTag that identifies a bus has configuration information for the bus on a per slot basis.

It is the caller's responsibility to know how much and what sort of information is returned, so that configInfo is set pointing to a sufficiently large space and the resulting information can be interpreted.

Both parameter0 and parameter1 are defined on a per bus architecture basis. Their meanings must be the same on all implementations of a particular bus but vary from one bus to another. One or both of these parameters can be unused; and if unused, should be set to 0.

The following are the parameter values for the specified bus type: