IRegister::MoveOut32

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 an 32-bit block of data from local memory to the specified memory space (assigned memory base + offset). This function writes the 32-bit value to the address space pointed to by space. The offset must be a valid memory address in the 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 the session object a MEMACC session, the offset parameters are absolute offsets from the start of memory in the specified VXI address space.

The MoveOutX functions do a block move of memory from a VXI device if the DestinationIncrement property is 1. However, they do a FIFO read of a VXI memory location if the DestinationIncrement property is 0 (zero).

VB Prototype

MoveOut32( space As Short, offset As Long, length As Long, buf32 As SAFEARRAY(BYTE) )

C++ Prototype

HRESULT MoveOut32( short space, long offset, long length, SAFEARRAY(long)* buf32 );

Parameters

space

Specifies the address space.

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.

offset

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

length

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

buf32

Data to write to bus.

Return Value