beautypg.com

Createevent() – Intel Extensible Firmware Interface User Manual

Page 103

background image

Services — Boot Services

Version 1.10

12/01/02

5-5

CreateEvent()

Summary

Creates an event.

Prototype

EFI_STATUS
CreateEvent (

IN UINT32

Type,

IN EFI_TPL

NotifyTpl,

IN EFI_EVENT_NOTIFY

NotifyFunction,

IN VOID

*NotifyContext,

OUT EFI_EVENT

*Event

);

Parameters

Type

The type of event to create and its mode and attributes. The

#define

statements in “Related Definitions” can be used to

specify an event’s mode and attributes.

NotifyTpl

The task priority level of event notifications. See

RaiseTPL()

.

NotifyFunction

Pointer to the event’s notification function. See “Related
Definitions.”

NotifyContext

Pointer to the notification function’s context; corresponds to
parameter

Context

in the notification function.

Event

Pointer to the newly created event if the call succeeds; undefined
otherwise.

Related Definitions

//*******************************************************
// EFI_EVENT
//*******************************************************
typedef VOID

*EFI_EVENT

//*******************************************************
// Event Types
//*******************************************************
// These types can be “ORed” together as needed – for example,
// EVT_TIMER might be “Ored” with EVT_NOTIFY_WAIT or
// EVT_NOTIFY_SIGNAL.
#define EVT_TIMER

0x80000000

#define EVT_RUNTIME

0x40000000

#define EVT_RUNTIME_CONTEXT

0x20000000