INtime SDK Help
AttachRtHeap (deprecated)

From INtime 6.0 the INtime Service and Port objects have been deprecated.

New projects should not be started using these features, and existing projects will not work with XM mode. You will receive a compiler warning by default if you use these calls.

Makes a heap's memory resources available to one or more message port objects. The INtime kernel allocates buffers from this heap for receive operations on associated ports. The application must return these buffers to the heap when they are no longer needed.

BOOLEAN AttachRtHeap(
    RTHANDLE hHeap,    // heap handle
    RTHANDLE hPort     // port handle
);

Parameters

hHeap
A handle for a heap object.
hPort
A handle for the port to which to attach the heap.

Return Values

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

Status

E_OK 0x0000
No exceptional conditions occurred.
E_EXIST 0x0006
Either the hPort or hHeap parameter does not refer to an existing object.
E_STATE 0x0007
The port already has a heap attached.
E_TYPE 0x8002
Either hPort or the hHeap parameter is not a handle of the correct type.

Requirements

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

See Also

Port system calls