RtcplSetLocalPoolExpansionSize

The function RtcplSetLocalPoolExpansionSize determines the minimum number of bytes by which the local memory pool expands when it is exhausted.

Syntax

BOOL RtcplSetLocalPoolExpansionSize(
    DWORD Size
);

Parameters

Size

The minimum number of bytes by which the local memory pool will expand when it is exhausted. Note that this value cannot be less than 1024 bytes.

Return Values

A TRUE value if the function succeeds, otherwise FALSE.

Remarks

Changing this value may require a restart of the RTX Subsystem if it is running, as indicated by a GetLastError of ERROR_SUCCESS_RESTART_REQUIRED.

The default expansion size is 4096 bytes.

Local memory is a memory pool that RTX maintains to deterministically fulfill RTSS application memory requests. RTSS applications that allocate memory from the local pool don't have to request memory from Windows during each memory allocation. For more information on using local memory with RTX, see Local Memory.

Related RTX Properties Control Panel Features

Tab

Memory tab

Feature(s)

Local Memory Pool options

Requirements

Header RtxProp.h
Library RtxProp.lib
IntervalZero.com | Support | Give Feedback