NPAB_Write_Config_Space

Writes information to the configuration space for the bus architecture that keeps this information on a per slot basis.

Thread Context:Non-Blocking

Syntax

    LONG NPAB_Write_Config_Space (
       LONG   npaHandle,
       LONG   dataType,
       LONG   busTag,
       LONG   uniqueID,
       LONG   offset,
       void  *writeData
       );
    
    

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_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.
offset
(IN) The byte offset into the specified adapter or function's configuration space of the item to be written.
writeData
(IN) Points to the data item of type dataType that is to be written in the specified configuration address on the specified bus.

Return Values

The following table lists return values and descriptions.

0

Successful

4

The busTag parameter was invalid.

5

The function is not available.

Remarks

For most buses, this function does 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 value, a bus identifier and an offset in that bus's configuration space and performs whatever operations are necessary to deliver the value to the specified location.

This function is provided only for drivers that need to interact with configuration space. Usually, any “writes” to configuration space are done by the system or a configuration management utility before any drivers are loaded.