IVxiMemacc::MoveOut8

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 8-bit block of data from local memory to the specified memory space (assigned memory base + offset). This function writes the 8-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

MoveOut8( space As Short, offset As Long, length As Long, buf8 As SAFEARRAY(BYTE) )

C++ Prototype

HRESULT MoveOut8( short space, long offset, long length, SAFEARRAY(BYTE)* buf8 );

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.

buf8

Data to write to bus.

Return Value

Refer to the table of return codes.