INtime SDK Help
CopyRtData
INtime SDK v7.1 > About INtime > INtime Kernel > Memory management > CopyRtData

Copies data directly between RT memory objects.
This is useful to synchronize memory between hosts.

BOOLEAN CopyRtData(
    RTHANDLE hSrcHandle,
    LPVOID dwSrcOffset,
    RTHANDLE hDestHandle,
    LPVOID dwDestOffset,
    DWORD dwCount
);

Parameters

hSrcHandle
The RTHANDLE of the source memory area, or NULL_RTHANDLE if the source is the local process data segment.
dwSrcOffset
A DWORD indicating the first byte in the source address space to copy.
hDestHandle
The RTHANDLE of the destination memory area, or NULL_RTHANDLE if the destination is the local process data segment.
dwDestOffset
A DWORD indicating the location of the first copied byte in the destination address space.
dwCount
The number of bytes to copy.

Return Values

TRUE
Success.
FALSE
Failure. To determine the status, call GetLastRtError.

Status

EH_GENERAL_PROTECTION 0x810d
An attempt was made to write to memory outside the area indicated by the memory handle.
EH_PAGE_FAULT 0x810e
An attempt was made to write to an area of the process data segment with no physical memory allocated to it.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/rt/include/rt.h rt.h rt.lib
See Also