GetTimerIOReq

Gets an IOReq for use with timer utilities.

Synopsis

Item GetTimerIOReq (void)

Description

Obtains an IOReq item for use with the other timer utilities that take an IOReq parameter. Use DeleteItem() to release the IOReq item when you no longer need it.

Timer-related functions which take an IOReq parameter perform much faster if you allocate the IOReq using this function and pass it to the other functions. Letting the other functions create and delete an IOReq on each call is appropriate only if you're planning to call the function just a few times throughout the run of your program.

Return Value

An IOReq item number, or a negative error code.

Implementation

Library call implemented in lib3do.lib.

Associated Files

lib3do.lib, timerutils.h