IDvdInfo2 Interface
The IDvdInfo2 interface is implemented by the DVD Navigator source filter and provides methods to query for various attributes of the disc or the DVD Navigator's state. IDvdInfo2 is the companion interface to IDvdControl2 interface. IDvdInfo2 groups the DVD Navigator's "get" methods and IDvdControl2 groups the "set" methods. Together they provide DVD navigation and playback functionality beyond the DVD Annex J specification.
Note The information provided by some of these methods can also be obtained through event notifications sent from the DVD Navigator to the application's message loop. For example, to get the current DVD domain, you can call IDvdInfo2::GetCurrentDomain or you can handle the EC_DVD_DOMAIN_CHANGE event in your application's message loop and extract the new domain from the event's lParam1 parameter.
In addition to the methods inherited from IUnknown, the IDvdInfo2 interface exposes the following methods.
Menus
| Method |
Description |
| GetButtonAtPosition |
Retrieves the button located at the specified point within the display window. |
| GetButtonRect |
Retrieves the rectangle coordinates of the specified button. |
| GetCurrentButton |
Retrieves the number of available buttons and the number of the currently selected button. |
| GetDefaultMenuLanguage |
Retrieves the default menu language. |
| GetMenuLanguages |
Retrieves all the languages available for all menus on the disc. |
| GetVMGAttributes |
Retrieves attributes of all video, audio, and subpicture streams for the video manager menu. |
Titles
| Method |
Description |
| GetNumberOfChapters |
Retrieves the number of chapters in a given title. |
| GetTitleAttributes |
Retrieves attributes of all video, audio, and subpicture streams for the specified title and its menus. |
| GetTotalTitleTime |
Retrieves the total playback time for the current title. |
Disc Information
| Method |
Description |
| GetAllSPRMs |
Retrieves the current contents of all system parameter registers (SPRMs). |
| GetAllGPRMs |
Retrieves the current contents of all general parameter registers (GPRMs). |
| GetCurrentUOPS |
Retrieves a set of flags indicating which navigation commands, if any, the content authors have explicitly disabled for the current disc location. |
| GetDiscID |
Retrieves a system-generated 64-bit "unique" identification number for the specified DVD. |
| GetDVDVolumeInfo |
Retrieves the current DVD volume information. |
Video Stream
| Method |
Description |
| GetCurrentAngle |
Retrieves the number of available angles in the current angle block and the currently selected angle number. |
| GetCurrentVideoAttributes |
Retrieves the video attributes of the current title or menu. |
Audio Stream
| Method |
Description |
| GetAudioAttributes |
Retrieves the attributes of the specified audio stream in the current title or menu. |
| GetAudioLanguage |
Retrieves the language of the specified audio stream within the current title. |
| GetCurrentAudio |
Retrieves the number of available audio streams and the number of the currently selected audio stream. |
| GetDecoderCaps |
Retrieves the DVD decoder's maximum data rate for video, audio, and subpicture (in forward and reverse) as well as support for various types of audio (Dolby AC-3, MPEG-2, DTS, SDDS, LPCM). |
| GetDefaultAudioLanguage |
Retrieves the default audio language. |
| GetKaraokeAttributes |
Retrieves the karaoke attributes of the specified audio stream in the current title or menu. |
| IsAudioStreamEnabled |
Determines if the specified audio stream is enabled in the current title. |
Subpicture Stream
| Method |
Description |
| GetCurrentSubpicture |
Retrieves the number of available subpicture streams in the current title, the currently selected subpicture stream number, and the state of the subpicture. |
| GetDefaultSubpictureLanguage |
Retrieves the default subpicture language. |
| GetSubpictureAttributes |
Retrieves the attributes of the specified subpicture stream in the current title or menu. |
| GetSubpictureLanguage |
Retrieves the language of the specified subpicture stream within the current title. |
| IsSubpictureStreamEnabled |
Determines if the specified subpicture stream is enabled in the current title. |
Parental Levels
| Method |
Description |
| GetPlayerParentalLevel |
Retrieves the current parental level and ISO 3166 country/region code settings for the DVD Navigator. |
| GetTitleParentalLevels |
Retrieves the parental levels that are defined for a particular title. |
DVD Navigator State Information
| Method |
Description |
| GetCmdFromEvent |
Retrieves an IDvdCmd object from an EC_DVD_CMD_START, EC_DVD_CMD_END, or VFW_E_DVD_CMD_CANCELLED event. |
| GetCurrentDomain |
Retrieves the DVD domain in which the DVD Navigator is currently located. |
| GetCurrentLocation |
Retrieves the current playback location. |
| GetDVDDirectory |
Retrieves the root directory that is set in the DVD Navigator. |
| GetState |
Retrieves a bookmark containing the disc location and DVD Navigator state information. |
DVD Text Strings