IRegister::Move

Note: Keysight's VISA COM does not support a COM server for VXI. The IVxi-related interfaces are listed in this help file because they are included in the global VISA COM library.

Description

Moves data from the specified source to the specified destination. The source and the destination can either be local memory or the offset of the interface with which this INSTR or MEMACC resource is associated. This operation uses the specified data width and address space.

If the session object is an INSTR session, the offset parameters specify relative offsets from the start of the instrument's address space. If session object is a MEMACC session, the offset parameters are absolute offsets from the start of memory in the specified VXI address space.

VB Prototype

Move( srcSpace As Short, srcOffset As Long, srcWidth As DataWidth, destSpace As Short, destOffset As Long, destWidth As DataWidth, length As Long )

C++ Prototype

HRESULT Move( short srcSpace, long srcOffset, DataWidth srcWidth, short destSpace, long destOffset, DataWidth destWidth, long length );

Parameters

srcSpace

Specifies the address space of the source.

The following values are legal:

VXI_A16_SPACE	Address the A16 address space of VXI/MXI bus.
VXI_A24_SPACE	Address the A24 address space of VXI/MXI bus.
VXI_A32_SPACE	Address the A32 address space of VXI/MXI bus.

srcOffset

Offset (in bytes) of the address or register from which to read.

srcWidth

Specifies the data width of the source.

destSpace

Specifies the address space of the destination.

The following values are legal:

VXI_A16_SPACE	Address the A16 address space of VXI/MXI bus.
VXI_A24_SPACE	Address the A24 address space of VXI/MXI bus.
VXI_A32_SPACE	Address the A32 address space of VXI/MXI bus.

destOffset

Offset (in bytes) of the starting address or register to which to write.

destWidth

Specifies the data width of the destination.

length

Number of elements to transfer, where the data width of the elements to transfer is identical to the source data width.

Return Value