IDvdInfo2 interface (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The IDvdInfo2 interface reports attributes of a DVD disc or the current state of DVD playback and navigation. The DVD Navigator filter implements this interface. 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.
Inheritance
The IDvdInfo2 interface inherits from the IUnknown interface. IDvdInfo2 also has these types of members:
Methods
The IDvdInfo2 interface has these methods.
| IDvdInfo2::GetAllGPRMs The GetAllGPRMs method retrieves the current contents of all general parameter registers (GPRMs). |
| IDvdInfo2::GetAllSPRMs The GetAllSPRMs method retrieves the current contents of all system parameter registers (SPRMs). |
| IDvdInfo2::GetAudioAttributes The GetAudioAttributes method retrieves the attributes of the specified audio stream in the current title or menu. |
| IDvdInfo2::GetAudioLanguage The GetAudioLanguage method retrieves the language of the specified audio stream within the current title. |
| IDvdInfo2::GetButtonAtPosition The GetButtonAtPosition method retrieves the button located at the specified point within the display window. |
| IDvdInfo2::GetButtonRect The GetButtonRect method retrieves the rectangle coordinates for the specified menu button. Note This method is currently not implemented. . |
| IDvdInfo2::GetCmdFromEvent The GetCmdFromEvent method retrieves an IDvdCmd object from an EC_DVD_CMD_START or EC_DVD_CMD_END event. |
| IDvdInfo2::GetCurrentAngle The GetCurrentAngle method retrieves the number of available angles in the current angle block and the currently selected angle number. |
| IDvdInfo2::GetCurrentAudio The GetCurrentAudio method retrieves the number of available audio streams and the number of the currently selected audio stream. |
| IDvdInfo2::GetCurrentButton The GetCurrentButton method retrieves the number of available buttons and the number of the currently selected button. |
| IDvdInfo2::GetCurrentDomain The GetCurrentDomain method retrieves the domain in which the DVD Navigator is currently located. |
| IDvdInfo2::GetCurrentLocation The GetCurrentLocation method retrieves the current playback location. |
| IDvdInfo2::GetCurrentSubpicture The GetCurrentSubpicture method retrieves the number of available subpicture streams in the current title, the currently selected subpicture stream number, and the state of the subpicture. |
| IDvdInfo2::GetCurrentUOPS The GetCurrentUOPS method retrieves a set of flags indicating which navigation commands, if any, the content authors have explicitly disabled for the current disc location. |
| IDvdInfo2::GetCurrentVideoAttributes The GetCurrentVideoAttributes method retrieves the video attributes of the current title or menu. |
| IDvdInfo2::GetDecoderCaps The GetDecoderCaps method 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 (AC-3, MPEG-2, DTS, SDDS, LPCM). |
| IDvdInfo2::GetDefaultAudioLanguage The GetDefaultAudioLanguage method retrieves the default audio language. |
| IDvdInfo2::GetDefaultMenuLanguage The GetDefaultMenuLanguage method retrieves the default menu language. |
| IDvdInfo2::GetDefaultSubpictureLanguage The GetDefaultSubpictureLanguage method retrieves the default subpicture language. |
| IDvdInfo2::GetDiscID The GetDiscID method retrieves a system-generated 64-bit identification number for the specified DVD. |
| IDvdInfo2::GetDVDDirectory The GetDVDDirectory method retrieves the root directory that is set in the DVD Navigator. |
| IDvdInfo2::GetDVDTextLanguageInfo The GetDVDTextLanguageInfo method retrieves information about the text strings for a specified language. The method retrieves the number of strings for that language, the locale identifier, and the character set. |
| IDvdInfo2::GetDVDTextNumberOfLanguages The GetDVDTextNumberOfLanguages method retrieves the number of languages in which DVD text strings appear. |
| IDvdInfo2::GetDVDTextStringAsNative The GetDVDTextStringAsNative method retrieves a DVD text string for a specified language, and returns the text string as an array of bytes. |
| IDvdInfo2::GetDVDTextStringAsUnicode The GetDVDTextStringAsUnicode method retrieves a DVD text string for a specified language, and returns the text string as a Unicode string. |
| IDvdInfo2::GetDVDVolumeInfo The GetDVDVolumeInfo method retrieves the current DVD volume information. |
| IDvdInfo2::GetKaraokeAttributes The GetKaraokeAttributes method retrieves the karaoke attributes of the specified audio stream in the current title or menu. |
| IDvdInfo2::GetMenuLanguages The GetMenuLanguages method retrieves all the languages available for all menus on the disc. |
| IDvdInfo2::GetNumberOfChapters The GetNumberOfChapters method retrieves the number of chapters in a given title. |
| IDvdInfo2::GetPlayerParentalLevel The GetPlayerParentalLevel method retrieves the current parental level and ISO 3166 country/region code settings for the DVD Navigator. |
| IDvdInfo2::GetState The GetState method retrieves a bookmark containing the disc location and DVD Navigator state information. |
| IDvdInfo2::GetSubpictureAttributes The GetSubpictureAttributes method retrieves the attributes of the specified subpicture stream in the specified title or menu. |
| IDvdInfo2::GetSubpictureLanguage The GetSubpictureLanguage method retrieves the language of the specified subpicture stream within the current title. |
| IDvdInfo2::GetTitleAttributes The GetTitleAttributes method retrieves attributes of all video, audio, and subpicture streams for the specified title and its menus. |
| IDvdInfo2::GetTitleParentalLevels The GetTitleParentalLevels method retrieves the parental levels that are defined for a particular title. |
| IDvdInfo2::GetTotalTitleTime The GetTotalTitleTime method retrieves the total playback time for the current title. |
| IDvdInfo2::GetVMGAttributes The GetVMGAttributes method retrieves attributes of all video, audio, and subpicture streams for the Video Manager Menu. |
| IDvdInfo2::IsAudioStreamEnabled The IsAudioStreamEnabled method determines if the specified audio stream is enabled in the current title. |
| IDvdInfo2::IsSubpictureStreamEnabled The IsSubpictureStreamEnabled method determines if the specified subpicture stream is enabled in the current title. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2003 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |