Carbon


HighLevelEventMsg

Header: EPPC.h

struct HighLevelEventMsg {
    UInt16 HighLevelEventMsgHeaderLength; 
    UInt16 version; 
    UInt32 reserved1; 
    EventRecord theMsgEvent; 
    UInt32 userRefcon; 
    UInt32 postingOptions; 
    UInt32 msgLength;
};
typedef HighLevelEventMsg HighLevelEventMsgPtr;

Field descriptions

HighLevelEventMsgHeaderLength

Reserved for use by the Event Manager.

version

Reserved for use by the Event Manager.

reserved1

Reserved for use by the Event Manager.

theMsgEvent

The event structure of a high-level event. Your filter function can compare the fields of this event structure to determine whether the high-level event is the desired event. If your filter function finds the desired event, it should call AcceptHighLevelEvent to accept the event and remove the event from the high-level event queue, and return true as its function result.

userRefcon

A unique number that identifies the communication associated with this event.

postingOptions

Reserved for use by the Event Manager.

msgLength

Reserved for use by the Event Manager.

You can search your application’s high-level event queue for a specific high-level event by using the GetSpecificHighLevelEvent and providing a filter function. Your filter function receives a pointer to a high-level event message structure that contains information about a high-level event.

For information on getting a function descriptor for your filter function, see“Resources”. For information on how to define a filter function, see GetSpecificFilterProcPtr.

A structure of type HighLevelEventMsg defines a high-level event message structure.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)