RtGetFlushTLBTickMod

The function RtGetFlushTLBTickMod allows an RTSS process to query the current frequency at which the Cache Translation Lookaside Buffer (TLB) is flushed for RTSS cores. The frequency of the TLB is a modulo of the Subsystem's HAL tick count.

Note: RtGetFLushTLBTickMod is only supported in the RTSS environment. It cannot be called from a Windows application linked to wRTOS.

Syntax

Copy
BOOL RtGetFlushTLBTickMod(
    [out]   ULONG *pTickMod
);

Parameters

[out] pTickMod

A pointer to a ULONG that stores the current frequency at which the RTSS cores’ TLB is flushed. This value is a mod of the HAL timer period. For example, if your HAL timer period is set to 100 microseconds, and you get back a value of 2, the real-time Subsystem will flush the cache‘s TLB every 200 microseconds.

Return Value

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE.

Remarks

Cache TLB flushing is handled by the real-time Subsystem whenever a RTSS core is idle. By default, the TickMod value is 0, which means periodic flushing of the TLB is disabled.

For performance purposes, the TLB flush frequency must be a power of 2. If you previously use RtSetFlushTLBTickMod with a TickMod value that is not a power of 2, the Subsystem already truncated that value into a value of the nearest power of 2. In such a case, the TickMod value RtGetFlushTLBTickMod queries will not equal the previous setting value.

Requirements

Minimum supported version Header Library

wRTOS 1.0 SDK

RtssApi.h

Startup.lib

See Also: