Microsoft® DirectShow™ supports system-defined events, which filters in the filter graph pass to the filter graph manager. Filters pass these events to the filter graph manager by using the IMediaEventSink::Notify method, and the application retrieves them with the IMediaEvent::GetEvent method.
When you retrieve an event by calling GetEvent, the event can contain interface pointers or pointers to allocated memory. Code that uses GetEvent should, therefore, call IMediaEvent::FreeEventParams to free any resources associated with the event's parameters after it handles the event.
The digital versatile disc (DVD) event notification codes are listed in Dvdevcod.h. See Event Notification Codes for non-DVD event notification codes. The following list shows the available DVD event notification codes in alphabetical order.
DVD event notification code | Description |
EC_DVD_ANGLE_CHANGE | Signals that either the number of available angles changed or that the current user angle number changed. |
EC_DVD_AUDIO_STREAM_CHANGE | Signals that the current user audio stream number changed for the main title. |
EC_DVD_BUTTON_CHANGE | Signals that either the number of available buttons changed or that the currently selected button number changed. |
EC_DVD_CHAPTER_AUTOSTOP | Indicates that playback stopped as the result of a call to the IDvdControl::ChapterPlayAutoStop method. |
EC_DVD_CHAPTER_START | Signals that the DVD player started playback of a new program in the DVD_DOMAIN_Title domain. |
EC_DVD_CURRENT_TIME | Signals the beginning of every video object unit (VOBU), which occurs every 0.4 to 1.0 seconds. |
EC_DVD_DOMAIN_CHANGE | Indicates the DVD player's new domain. |
EC_DVD_ERROR | Signals a DVD error condition. |
EC_DVD_STILL_OFF | Signals the end of any still (PGC, Cell, or VOBU). |
EC_DVD_STILL_ON | Signals the beginning of any still (PGC, Cell, or VOBU). |
EC_DVD_SUBPICTURE_STREAM_CHANGE | Signals that the current user subpicture stream number changed for the main title. |
EC_DVD_TITLE_CHANGE | Indicates when the current title number changes. |
EC_DVD_VALID_UOPS_CHANGE | Signals that the available set of IDvdControl interface methods has changed. |
EC_DVD_WARNING | Signals a DVD warning condition. |
Signals that either the number of available angles changed or that the current user angle number changed.
EC_DVD_ANGLE_CHANGE
Angle numbers range from 1 to 9.
The current angle number can change automatically with a navigation command authored on the disc as well as through application control by using the IDvdControl interface.
All domains (DVD_DOMAIN) raise this event.
Signals that the current user audio stream number changed for the main title.
EC_DVD_AUDIO_STREAM_CHANGE
The current user audio stream can change automatically with a navigation command authored on the disc as well as through application control by using the IDvdControl interface.
All domains (DVD_DOMAIN) raise this event.
Signals that either the number of available buttons changed or that the currently selected button number changed.
EC_DVD_BUTTON_CHANGE
Button numbers range from 1 to 36.
The currently selected button can change automatically with a navigation command authored on the disc as well as through application control by using IDvdControl interface.
This event can signal any of the available button numbers. These numbers do not always correspond to button numbers used for IDvdControl::ButtonSelectAndActivate because that method can activate only a subset of buttons.
All domains (DVD_DOMAIN) raise this event.
Indicates that playback stopped as the result of a call to the IDvdControl::ChapterPlayAutoStop method.
EC_DVD_CHAPTER_AUTOSTOP
The DVD_DOMAIN_Title domain raises this event.
Signals that the DVD player started playback of a new program in the DVD_DOMAIN_Title domain.
EC_DVD_CHAPTER_START
Only simple linear movies signal this event.
The DVD_DOMAIN_Title domain raises this event.
Signals the beginning of every video object unit (VOBU), which occurs every 0.4 to 1.0 seconds.
EC_DVD_CURRENT_TIME
Only simple linear movies signal this event.
The DVD_DOMAIN_Title domain raises this event.
Indicates the DVD player's new domain.
EC_DVD_DOMAIN_CHANGE
The DVD player signals this event whenever it changes domains.
All domains (DVD_DOMAIN) raise this event.
Signals a DVD error condition.
EC_DVD_ERROR
All domains (DVD_DOMAIN) raise this event.
Signals the end of any still (PGC, Cell, or VOBU).
EC_DVD_STILL_OFF
This event indicates that any currently active still has been released.
All domains (DVD_DOMAIN) raise this event.
Signals the beginning of any still (PGC, Cell, or VOBU).
EC_DVD_STILL_ON
All combinations of buttons and still are possible (buttons on with still on, buttons on with still off, button off with still on, button off with still off).
All domains (DVD_DOMAIN) raise this event.
Signals that the current user subpicture stream number changed for the main title.
EC_DVD_SUBPICTURE_STREAM_CHANGE
The subpicture can change automatically with a navigation command authored on disc as well as through application control using IDvdControl.
All domains (DVD_DOMAIN) raise this event.
Indicates when the current title number changes.
EC_DVD_TITLE_CHANGE
Title numbers range from 1 to 99. This number indicates the TTN, which is the title number with respect to the whole disc, not the VTS_TTN which is the title number with respect to just a current VTS.
The DVD_DOMAIN_Title domain raises this event.
Signals that the available set of IDvdControl interface methods has changed.
EC_DVD_VALID_UOPS_CHANGE
This event indicates only which operations are explicitly disabled by the content on the DVD disc, and does not guarantee that it is valid to call methods that are not disabled. For example, if no buttons are present, the IDvdControl::ButtonActivate method won't work, even though the buttons are not explicitly disabled.
All domains (DVD_DOMAIN) raise this event.
Signals a DVD warning condition.
EC_DVD_WARNING
All domains (DVD_DOMAIN) raise this event.
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.