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

See Also

Region system calls,