HP-UX

NAME

viMapAddress − Maps in specified memory space

SYNOPSIS

viMapAddress(ViSession vi, ViUInt16 mapSpace,
ViBusAddress mapBase, ViBusSize mapSize,
ViBoolean access, ViAddr suggested, ViPAddr address);

Description

 
This function maps in a specified memory space.  The memory space that is mapped is dependent on the type of interface specified by the vi parameter and the mapSpace parameter (refer to the following table). The address parameter returns the address in your process space where memory is mapped.
 
NOTE For a given session, you can only have one map at one time.  If you need to have multiple maps to a device, you must open one session for each map needed.
 
 

Parameters

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

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

mapBase An input parameter. Offset (in bytes) of the memory to be mapped. 
 

mapSize An input parameter. Amount of memory to map (in bytes). 
 

access An input parameter. VI_FALSE. 
 

suggested An input parameter.  If suggested parameter is not VI_NULL, the operating system attempts to map the memory to the address specified in suggested.  There is no guarantee, however, that the memory will be mapped to that address.  This function may map the memory into an address region different from suggested. 
 

address An output parameter. Address in your process space where the memory was mapped. 
 

Values for mapSpace 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 Map successful. 
 
 

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_INV_SPACE Invalid mapSpace specified. 
 

VI_ERROR_INV_OFFSET Invalid offset specified. 
 

VI_ERROR_NSUP_OFFSET Specified region is not accessible from this hardware. 
 

VI_ERROR_TMO viMapAddress could not acquire resource or perform mapping before the timer expired. 
 

VI_ERROR_INV_SIZE Invalid size of window specified. 
 

VI_ERROR_ALLOC Unable to allocate window of at least the requested size. 
 

VI_ERROR_INV_ACC_MODE Invalid access mode. 
 

VI_ERROR_WINDOW_MAPPED The specified session already contains a mapped window. 
 

See Also

 
viUnmapAddress
 

AUTHOR

viMapAddress was developed by HP
 

Hewlett-Packard Comapny  —  September 29, 1999