Ivi_LoadSimulationDriver
Usage
ViStatus Ivi_LoadSimulationDriver (ViChar defaultSoftwareModule[], ViString functionList[], ViSession vi);
Purpose
This function is used by class drivers to load the class simulation driver when class simulation is enabled for the Logical Name or Driver Session in the IVI Configuration Store.
Typically, this function is called once when the class driver is initialized to load the class simulation driver DLL specified in the IVI configuration store.
Parameters
| Input | ||
| Name | Type | Description |
|---|---|---|
| defaultSoftwareModule | ViChar[] | This parameter specifies the default simulation driver software module item in the IVI Configuration Store that should be used as the simulation driver if the logical names passed to the <Class>_Initialize function refers to a non-existent or invalid simulation driver session item. In this case, the value passed in this parameter is used to locate and load the simulation driver. |
| functionList | ViString[] | Specifies the names of all functions that the class driver looks for in any simulation driver that complies with the class API. This list should include all of the functions defined by the IVI class specification for which the simulation driver supports class-level simulation. In addition, the functions SimulationInit and SimulationClose must also be included in this list. These are special functions that are used to initialize and close the simulation driver. |
| vi | ViSession | The ViSession handle that you obtain from Ivi_SpecificDriverNew. The handle identifies a particular IVI session. |
Return Value
Contains the status code that the function call returns. IVI engine functions can return error and warning values from several sets of status codes. Some status codes are unique to the IVI engine. Other status codes are the same codes that VISA Library functions return. Still others are error or warning values that functions in specific instrument drivers return. Each set of status codes has its own numeric range.
Regardless of the source of the status code, 0 always indicates success, a positive value indicates a warning, and a negative value indicates an error.