Syntax

    LONG NPAB_Read_Config_Space (
       LONG   npaHandle,
       LONG   dataType,
       LONG   busTag,
       LONG   uniqueID,
       LONG   offset,
       void  *readData
       );
    
    

Parameters

npaHandle

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

dataType

(IN) Indicates the data type (and size) of the output data:

Value	Data Type	Size
0	BYTE	8 bits
1	WORD	16 bits
2	LONG	32 bits

busTag

(IN) An architecture-dependent value returned by NPAB_Search_Adapteror 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.

offset

(IN) The byte offset into the specified adapter or function's configuration space of the item to be read.

readData

(OUT) Points to a value of type dataType.

Return Values

The following table lists return values and descriptions.

Remarks

For most buses, this function will do nothing. It has meaning only on buses that have a configuration address space that is separate from memory or I/O space (for example, a PCI bus).

This function takes a bus identifier and an offset in that bus's configuration space and performs whatever operations are necessary to acquire and return the requested data.

This function is provided only for drivers that need to interact with configuration space. On most buses, NPAB_Get_Card_Config_Info will satisfy a driver's needs.