Syntax

    LONG HAI_Activate_Bus (
       LONG  *npaBusHandle,
       LONG   hamBusHandle,
       LONG   npaHandle
       );
    
    

Parameters

npaBusHandle

(IN/OUT) Address of a local variable of type LONG. Receives an NWPA-generated handle for the target bus the HAM is managing. This handle is NWPA's counterpart to the HAM's hamBusHandle. This handle is used in conjunction with the HAM-generated hamBusHandle to uniquely identify a HAM when it interfaces with NWPA through the HAI API set.

hamBusHandle

(IN) HAM-generated handle to a bus instance the HAM is managing. From this handle, the HAM must be able to locate its list of devices attached to the bus.

npaHandle

The HAM's handle for using the NPA APIs. Its value was assigned during NPA_Register_HAM_Module.

Return Values

The following table lists return values and descriptions.

Remarks

HAI_Activate_Bus is used to activate a bus instance managed by the HAM. This is the last API called within HAM_Load prior to HAM_Load returning its thread to the OS.