GetVBLTime

Obtains the current VBL timer values.

Synopsis

int32 GetVBLTime (Item ioreq, uint32 *hiorder, uint32 *loworder)

Description

This function obtains the current value of the system VBL timer and stores the results at *hiorder and *loworder. Either pointer can be NULL. The loworder part of the VBL timer is generally of most interest, it doesn't roll over into the high-order part until roughly 800 days of continuous running without a reboot.

Arguments

ioreq: IOReq item obtained from GetTimerIOReq(), or zero to have an IOReq dynamically created/deleted during the call.

hiorder: Pointer to a variable into which the high-order portion of the VBL time is stored.

loworder: Pointer to a variable into which the low-order portion of the VBL time is stored.

Return Value

The low-order portion of the VBL time (a positive value), or a negative error code.

Implementation

Library call implemented in lib3do.lib.

Associated Files

lib3do.lib, timerutils.h