INtime SDK Help
ntxRequestRtBuffer

Requests memory from the system. When the message received by ntxReceiveRtMessage is not a response to a previous request, the system allocates memory for the Windows application.

Allocates a memory buffer from a heap object and returns a pointer to the caller. If insufficient resources are available to meet the request, a NULL pointer is returned.

LPVOID ntxRequestRtBuffer(
    NTXHANDLE hPort
    DWORD dwBufferSize 
);

Parameters

hPort
Specifies the port and heap from which to request a buffer.
dwBufferSize
The number of bytes of the buffer to allocate.

Return Values

A pointer to the allocated buffer.
Success.
A null pointer.
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