Move

Moves data from the specified source to the specified destination.

Syntax

virtual HRESULT Move(VisaAddressSpace eSrcSpace, UINT64 ullSrcOffset, VisaDataWidth eSrcWidth, VisaAddressSpace eDestSpace, UINT64 ullDestOffset, VisaDataWidth eDestWidth, UINT32 ulLength) abstract;

Parameters

eSrcSpace

[in] Address space from which the data will be moved.

ullSrcOffset

[in] Offset within eSrcSpace from which the data will be moved.

eSrcWidth

[in] Data width of the source data.

eDestSpace

[in] Address space to which the data will be moved.

ullDestOffset

[in] Offset within eDestSpace to which the data will be moved.

eDestWidth

[in] Data width of the destination data.

ulLength

[in] Number of elements (not byte) to transfer.

Return value

Returns S_OK if successful, otherwise a failure HRESULT.

Remarks

The Move function moves data from the specified source to the specified destination. The source and the destination can either be local memory or the offset of an address space within a register-based device. This function uses the specified data width and address space.

Example

The following example demonstrates use of the Move function.

STDMETHODIMP Acme4321::IAcme4321_MoveBlock()
{
  HRESULT hr = S_OK;

  // Move 1000 bytes 16-bit words
  hr = io.Memory.Move(VisaA16Space, 0x10, VisaDataWidth16, VisaA16Space, 0x20, VisaDataWidth16, 1000);

  return hr;
}