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

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

See Also

Memory management system calls, ntxImportRtHandle