.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "APM_GET_EVENT" "" "06 October 2005" "" ""

.SH NAME
apm_get_event \- get an APM event from the BIOS
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int apm_get_event  (apm_event_t * \fIevent\fB, apm_eventinfo_t * \fIinfo\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIevent\fB\fR
pointer to the event
.TP
\fB\fIinfo\fB\fR
point to the event information
.SH "DESCRIPTION"
.PP
The APM BIOS provides a polled information for event
reporting. The BIOS expects to be polled at least every second
when events are pending. When a message is found the caller should
poll until no more messages are present.  However, this causes
problems on some laptops where a suspend event notification is
not cleared until it is acknowledged.
.PP
Additional information is returned in the info pointer, providing
that APM 1.2 is in use. If no messges are pending the value 0x80
is returned (No power management events pending).