INtime SDK Help
ntxReleaseRtBuffer

Returns memory to the system. When the message received by ntxReceive is not a response to a previous request, the system allocates memory for the Windows application. By using this call, the memory is returned to the system for later use.

Returns a previously-allocated buffer to its heap. The buffer must have been allocated from the heap to which it is being returned. It does not have to be returned by the same process that allocated it.

NTXSTATUS ntxReleaseRtBuffer(
    NTXHANDLE hPort, 
    LPVOID lpReceiveBuffer
);

Parameters

hPort
Specifies the port and heap to which to release the buffer.
lpReceiveBuffer
Specifies a pointer returned from a call to ntxReceiveRtMessage.

Return Values

E_OK
Success.
The appropriate status code.
Failure. To determine the status, call ntxGetLastRtError.

Status

E_LOCATION
The RT client on which the port was created is now invalid.
E_NTX_INTERNAL_ERROR
The DLL could not contact the RT kernel to complete the request.

Requirements

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

See Also

Port system calls, ntxReceiveRtMessage