IRegister64::MoveOut64Ex

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 a 64-bit block of data from local memory to the specified memory space (assigned memory base + offset). This function writes the 64-bit value to the address space pointed to by space. The offset must be a valid memory address in the space.

Note: This method uses 64-bit integers. It can be used in Visual Basic.NET (VB.NET), but not in Visual Basic 6 (VB6) or earlier versions of Visual Basic.

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

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

C++ Prototype

HRESULT MoveOut64Ex( short space, int64 offset, long length, SAFEARRAY(int64)* 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.

buf32

Data to write to bus.

Return Value

Refer to the table of return codes.