Returns the current reload register value, the system hardware timer period in picosecond units (at the nominal timer input clock frequency), and an indicator to show whether a call to AdjustRtSystemTimer takes effect immediately or on the next system tick.

BOOLEAN GetRtSystemTimerValues(
    TIMERVALUES *pTimerValues;
);

typedef struct {
    uint32_t _reserved,
    uint32_t dwFlags,
    uint64_t ReloadValue,
    uint64_t ClockPeriod,
} TIMERVALUES;

#define RELOAD_COUNT_AT_NEXT_TICK   0x00000001

Parameters

pTimerValues

A pointer to the TIMERVALUES structure to receive the values.

Fields

dwFlags

Contains information about the behavior of the timer. The bitmask value RELOAD_COUNT_AT_NEXT_TICK is set if a call to AdjustRtSystemTimer will take immediate effect or on the next system tick.

ReloadValue

The current value of the hardware timer reload timer register. The units are hardware-dependent.

ClockPeriod

The period of the system hardware timer in picoseconds. Thus the system timer period is ClockPeriod * ReloadValue, in picoseconds.

Remarks

Note that a call to GetRtSystemTimerValues that follows a call to AdjustRtSystemTimer may not return the adjusted ReloadValue until after the next system timer tick.

Return Values

TRUE

Success

FALSE

To determine the status, call GetLastRtError

Status

E_BAD_ADDR 0x800f

pTimerValues is not a valid pointer to writable memory.

Requirements