Ivi_WriteInstrData
Usage
ViStatus Ivi_WriteInstrData(ViSession vi, ViChar writeBuffer[ ]);
Purpose
This function writes a command string directly to an instrument using VISA I/O. The function bypasses the attribute state caching mechanism and therefore always invalidates all attribute cache values for the session. Use this function only to implement the PREFIX_WriteInstrData function that your instrument driver exports to the end-user.
The function assumes that the IVI_ATTR_IO_SESSION attribute for the IVI session you specify holds a valid VISA session for the instrument.
The function calls Ivi_SetNeedToCheckStatus with VI_TRUE.
Parameters
| Name | Type | Description |
|---|---|---|
| vi | ViSession |
The ViSession handle that you obtain from Ivi_SpecificDriverNew. The handle identifies a particular IVI session. |
| writeBuffer | ViChar[ ] |
Specify the string you want to send to the instrument. |
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.