beautypg.com

Cilxs_writeinstrdata – AMETEK Ls Series Driver Manual User Manual

Page 268

background image

IVI Driver Manual

Lx / Ls Series

264

ciLxs_WriteInstrData


ViStatus ciLxs_WriteInstrData (ViSession instrumentHandle,
ViChar _VI_FAR writeBuffer[]);

Purpose

This function writes a user-specified string to the instrument.

Note: This function bypasses IVI attribute state caching. Therefore,
when you call this function, the cached values for all attributes will be
invalidated.

Parameter List

instrumentHandle

Variable Type ViSession

The ViSession handle that you obtain from the ciLxs_init or
ciLxs_InitWithOptions function. The handle identifies a particular
instrument session.

Default Value: None


writeBuffer

Variable Type ViChar[]

Pass the string to be written to the instrument.

Return Value

Returns the status code of this operation. The status code either
indicates success or describes an error or warning condition. You
examine the status code from each call to an instrument driver
function to determine if an error occurred.

To obtain a text description of the status code, call the
ciLxs_error_message function. To obtain additional information about
the error condition, call the ciLxs_GetError function. To clear the
error information from the driver, call the ciLxs_ClearError
function.

The general meaning of the status code is as follows:

Value Meaning
-------------------------------
0 Success
Positive Values Warnings
Negative Values Errors

This driver defines the following status codes:

Status Description
-------------------------------------------------

This manual is related to the following products: