jobId OUT ViJobId Represents the location of a variable that will be set to the job identifier of this asynchronous write operation. Return Values This is the operational return status. It returns either a Type ViStatus completion code or an error code as follows. Completion Codes Description VI_SUCCESS Asynchronous write operation successfully queued. VI_SUCCESS_SYNC Write operation performed synchronously. Error Codes Description VI_ERROR_INV_SESSION The given session or object reference is invalid (both VI_ERROR_INV_OBJECT are the same value). VI_ERROR_RSRC_LOCKED Specified operation could not be performed because the resource identified by has been locked for this vi kind of access. VI_ERROR_QUEUE_ERROR Unable to queue write operation. VI_ERROR_IN_PROGRESS Unable to start a new asynchronous operation while another asynchronous operation is in progress. Description The write operation asynchronously transfers data. The data to be written is in the buffer represented by This operation normally returns before the transfer terminates. An I/O Completion event will be buf. posted when the transfer is actually completed. The operation returns which you can use with either to abort the operation or jobId, viTerminate() with an I/O Completion event to identify which asynchronous write operation completed. Table 6.1.5 Special Values for Parameter jobId Value Action Description VI_NULL Do not return a job identifier. Related Items See the INSTR resource description. Also see and viRead(), viTerminate(), viReadAsync(), viWrite(). Implementation Requirements RULE 6.1.16 IF the output parameter is not THEN the value in SHALL be valid before jobId VI_NULL, jobId begins the data transfer. viWriteAsync() OBSERVATION 6.1.14
jobId OUT ViJobId Represents the location of a variable that will be set to the job identifier of this asynchronous write operation. Return Values Type ViStatus This is the operational return status. It returns either a completion code or an error code as follows. Completion Codes Description VI_SUCCESS Asynchronous write operation successfully queued. VI_SUCCESS_SYNC Write operation performed synchronously. Error Codes Description VI_ERROR_INV_SESSION VI_ERROR_INV_OBJECT The given session or object reference is invalid (both are the same value). VI_ERROR_RSRC_LOCKED Specified operation could not be performed because the resource identified by vi has been locked for this kind of access. VI_ERROR_QUEUE_ERROR Unable to queue write operation. VI_ERROR_IN_PROGRESS Unable to start a new asynchronous operation while another asynchronous operation is in progress. Description The write operation asynchronously transfers data. The data to be written is in the buffer represented by buf. This operation normally returns before the transfer terminates. An I/O Completion event will be posted when the transfer is actually completed. The operation returns jobId, which you can use with either viTerminate() to abort the operation or with an I/O Completion event to identify which asynchronous write operation completed. Table 6.1.5 Special Values for jobId Parameter Value Action Description VI_NULL Do not return a job identifier. Related Items See the INSTR resource description. Also see viRead(), viTerminate(), viReadAsync(), and viWrite(). Implementation Requirements RULE 6.1.16 IF the output parameter jobId is not VI_NULL, THEN the value in jobId SHALL be valid before viWriteAsync() begins the data transfer. OBSERVATION 6.1.14
vpp43_2018-10-19.docx