Platform SDK: Broadcast Architecture

Sending Loader Event Notifications

Your loader DLL should broadcast Microsoft® Windows® operating system messages when loader events occur. These messages can be sent using either the SendMessageTimeout or PostMessage function, both part of the Microsoft® Win32® application programming interface (API).

The following table lists and describes the possible messages and the loader events they indicate.

Message Event
EPGLDR_ACTIVE_COMMIT_END The loader has finished updating records. Applications that cache Program Guide data should reload the cached data now.
EPGLDR_ACTIVE_COMMIT_EPIENHANCE_ENDING The loader has finished updating enhancement mapping identifiers. Applications that cache enhancement mapping identifiers should reload them. An enhancement mapping identifier maps data in the Enhancement table of the Guide database to a time slot, channel, or episode.
EPGLDR_ACTIVE_COMMIT_EPIENHANCE_STARTING The loader is starting to update enhancement mapping identifiers.
EPGLDR_ACTIVE_COMMIT_START The loader is beginning to update records. Applications that cache Program Guide data will need to reload the Program Guide data when updating ends.
EPGLDR_ENDING The loader is finished updating Program Guide data. This message is sent by Loadstub and does not need to be sent by your loader DLL.
EPGLDR_EXCLUSIVE _ENDING The loader has finished an operation that requires exclusive access to the Guide database. This message is sent by Loadstub and does not need to be sent by your loader DLL.
EPGLDR_EXCLUSIVE_STARTING The loader is beginning an operation that requires exclusive access to the Guide database. This message is sent by Loadstub and does not need to be sent by your loader DLL.
EPGLDR_PASSIVE_COMMIT_END The loader has finished updating records. Applications that cache Program Guide data do not need to reload Program Guide data.
EPGLDR_PASSIVE_COMMIT_START The loader is beginning to update records. Applications that cache Program Guide data do not need to reload Program Guide data.
EPGLDR_STARTING The loader is starting to run. This message is sent by Loadstub and does not need to be sent by your loader DLL.