beautypg.com

Comtrol API (6508) for the MS-DOS User Manual

Page 23

background image

23

API Functions

aaEnPeriodicEvent

aaEnPeriodicEvent

Enables or disables dispatching of the periodic event
function.

aaEnPeriodicEvent(State)
int State

TRUE

to enable dispatching of

the periodic event function,

FALSE

to disable dispatching.

void

The periodic event function is called 274 times a
second. Once installed, the periodic event function is
not dispatched until it is enabled with the
aaEnPeriodicEvent() function. The aaEnPeriodicEvent()
function can also be used to disable dispatching of the
periodic event function.

The event function must be installed with
aaInstallPeriodicEvent() before enabling dispatching.

Function

Purpose

Call

Return

Comments

Warning

aaExit

Performs cleanup when exiting from an application
program.

aaExit()

void

This function does cleanup tasks required when
exiting from an application, such as halting controller
interrupts and restoring the

IRQ

vector used by the

controller.

Once aaInit() has been called, aaExit() must be called
before exiting the application program.

If the application program can be exited using the

CTRL+C

or

CTRL+BREAK

keys, then the default

DOS

CTRL+C

handler must be replaced with a handler that

calls aaExit(). You can use the aaInstallCtrlCHandler()
function for this purpose.

Purpose

Call

Return

Comments

Warning