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

Copies data directly between NTX process space and an RT process memory region. Use this function when you want to omit the mapping step.

This is useful to synchronize memory between hosts.

Note:   If the NTX application must operate on copied data that contains RTHANDLEs, you must convert the handles using ntxImportRtHandle.
   
// 32-bit version
NTXSTATUS ntxCopyRtData(
    NTXHANDLE  hSrcSeg,
    DWORD dwSrcOffset,
    NTXHANDLE hDestSeg,
    DWORD dwDestOffset,
    DWORD dwLength
);

// 64-bit version
NTXSTATUS ntxCopyRtData(
    NTXHANDLE  hSrcSeg,
    unsigned __int64 dwSrcOffset,
    NTXHANDLE hDestSeg,
    unsigned __int64 dwDestOffset,
    unsigned __int64 dwLength
);

Parameters

hSrcSeg
The NTXHANDLE of the source memory area, or NULL if the source is Windows allocated memory.
dwSrcOffset
An offset indicating the first byte in the source address space to copy.
hDestSeg
The NTXHANDLE of the destination memory area, or NULL if the destination is Windows allocated memory.
dwDestOffset
An offset indicating the location of the first copied byte in the destination address space.
dwLength
The number of bytes to copy.

Return Values

The status code.

Status

E_PARAM 0x8004
Both or neither address space handles are NULL (not copying to or from Windows), or the region exceeds the bands of the RT address space.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/nt/include/ntx.h ntx.h ntx.lib
INtime 4.01 (64-bit Windows) intime/nt/include/ntx.h ntx.h ntx64.lib

See Also

Memory management system calls, ntxImportRtHandle