IVxiMemacc::MoveIn8

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 the specified memory space (assigned memory base + offset) to local memory. This function reads the 8-bit value from 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 is a MEMACC session, the offset parameters are absolute offsets from the start of memory in the specified VXI address space.

The MoveInX functions do a block move of memory from a VXI device if the SourceIncrement property is one. However, they do a FIFO read of a VXI memory location if the SourceIncrement property is zero.

VB Prototype

value As SAFEARRAY(BYTE) = MoveIn8( space As Short, offset As Long, length As Long )

C++ Prototype

HRESULT MoveIn8( short space, long offset, long length, SAFEARRAY(BYTE)* pBuf8 );

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 address or register from which to read.

length

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

pBuf8

Data read from bus

Return Value

Refer to the table of return codes.