Freigeben über


IDvdInfo2 Interface

 
Microsoft DirectShow 9.0

IDvdInfo2 Interface

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.

In addition to the methods inherited from IUnknown, the IDvdInfo2 interface exposes the following methods.

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

Method Description
GetDVDTextNumberOfLanguages Retrieves the number of text languages for the current DVD or disc side.
GetDVDTextLanguageInfo Retrieves the information for the specified text string language block.
GetDVDTextStringAsNative Retrieves the text string for the specified language as an array of bytes.
GetDVDTextStringAsUnicode Retrieves the text string for the specified language in Unicode™.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also