HP-UX

NAME

viIn8 − Reads an 8-bit value from specified memory

SYNOPSIS

viIn8(ViSession vi, ViUInt16 space, ViBusAddress offset,
ViPUInt8 val8);

Description

 
This function reads in an 8-bit value from the specified memory space (assigned memory base  offset).  This function takes the 8-bit value from the address space pointed to by space.  The offset must be a valid memory address in the space.  This function does not require viMapAddress to be called prior to its invocation.
 

Parameters

vi An input parameter. Unique logical identifier to a session. 
 

space An input parameter. Specifies the address space.  (See the following table.) 
 

offset An input parameter. Offset (in bytes) of the memory to read from. 
 

val8 An output parameter.  Data read from bus (8-bits). 
 
 

Values for space Parameter

VI_A16_SPACE  Maps in VXI/MXI A16 address space.
VI_A24_SPACE  Maps in VXI/MXI A24 address space.
VI_A32_SPACE  Maps in VXI/MXI A32 address space.

Return Values

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

VI_SUCCESS Operation completed successfully. 
 

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_BERR Bus error occurred during transfer. 
 

VI_ERROR_INV_SPACE Invalid address space specified. 
 

VI_ERROR_INV_OFFSET Invalid offset specified. 
 

VI_ERROR_NSUP_OFFSET Specified offset is not accessible from this hardware. 
 

VI_ERROR_NSUP_WIDTH Specified width is not supported by this hardware. 
 
 

See Also

 
viOut8 and viOut16
 

AUTHOR

viIn8 was developed by HP
 

Hewlett-Packard Comapny  —  September 29, 1999