InitEventUtility

Connects task to the event broker.

Synopsis

Err InitEventUtility( int32 numControlPads, int32 numMice,int32 focusListener )

Description

This convenience call allows a task to easily monitor events on controller pads or mice. This function connects the task to the event broker, sets the tasksfocusinterest,and'determines how many controller pads and mice the task wants to monitor.

The function creates a reply port and a message, sends a configuration message to the event broker (which asks the event broker to report appropriate mouse and controller pad events), and deals with the event brokersconfigurationreply.'

Arguments

numControlPads: The number of controller pads to monitor.

numMice: The number of mice to monitor.

focusListener: The focus of the task when it is connected as a listener. If the value is nonzero, the task is connected as a focus-dependent listener. If the value is zero, the task is connected as a focus-independent listener.

Return Value

This function returns a value greater than or equal to 0 if all went well or a negative error code if an error occurred.

Implementation

Convenience call implemented in input.lib V20.

Associated Files

event.h, input.lib