INtime SDK Help
CreateRtRegion
INtime SDK v7.1 > About INtime > INtime Kernel > Regions > CreateRtRegion

Creates a region object. A function parameter determines whether the region queues threads on a priority or a FIFO basis.

RTHANDLE CreateRtRegion(
    WORD wRegionFlags
);

Parameters

wRegionFlags
Determines the region's creation mode. Possible flags include:
FIFO_QUEUING Queues threads on this object in First-In-First-Out order.
PRIORITY_QUEUING Queues threads on this object in priority order.

Remarks

Threads that use regions cannot be deleted while they are in control of the region.

Return Values

The handle for the region.
Success.
BAD_RTHANDLE
Failure. To determine the status, call GetLastRtError.

Status

E_OK 0x0000
No exceptional conditions occurred.
E_MEM 0x0002
Creating a region requires more available memory to the calling thread's process than currently exists.
E_LIMIT 0x0004
The calling thread's process reached its object limit.
E_SLOT 0x000C
You cannot create more RT objects because the GDT's slots are full.

Requirements

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

See Also

Region system calls,