HP-UX

NAME

viWrite − Transfers data to a device

SYNOPSIS

viWrite(ViSession vi, ViBuf buf, ViUInt32 count, ViPUInt32 retCount);

Description

 
This function synchronously transfers data to a device.  The data to be written is in the buffer represented by buf.  This function returns only when the transfer terminates.  Only one synchronous write function can occur at any one time.
 

Parameters

buf An input parameter. Represents the location of a data block to be sent to device. 
 

count An input parameter. Specifies number of bytes to be written. 
 

retCount An output parameter. Represents the location of an integer that will be set to the number of bytes actually transferred. 
 
 

Return Values

 
This is the functional return status.  It returns either a completion code or an error code as follows.
 
 

VI_SUCCESS Transfer completed. 
 
 

VI_ERROR_INV_SESSION VI_ERROR_INV_OBJECT The given session or object reference is invalid (both are the same value). 
 

VI_ERROR_NSUP_OPER The given vi does not support this function. 
 

VI_ERROR_TMO Timeout expired before function completed. 
 

VI_ERROR_RAW_WR_PROT_VIOL Violation of raw write protocol occurred during transfer. 
 

VI_ERROR_RAW_RD_PROT_VIOL Violation of raw read protocol occurred during transfer. 
 

VI_ERROR_INP_PROT_VIOL Device reported an input protocol error occurred during transfer. 
 

VI_ERROR_BERR Bus error occurred during transfer. 
 

VI_ERROR_INV_SETUP Unable to start write function because setup is invalid (due to attributes being set to an inconsistent state). 
 

VI_ERROR_NCIC The interface associated with the given vi is not currently the controller in charge. 
 

VI_ERROR_NLISTENERS No Listeners condition is detected (both NRFD and NDAC are deasserted). 
 
 

See Also

 
viRead
 

AUTHOR

viWrite was developed by HP
 

Hewlett-Packard Comapny  —  September 29, 1999