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.
 

Members

The IDvdInfo2 interface inherits from the IUnknown interface. IDvdInfo2 also has these types of members:

Methods

The IDvdInfo2 interface has these methods.

MethodDescription
GetAllGPRMs

Retrieves the current contents of all general parameter registers (GPRMs).

GetAllSPRMs

Retrieves the current contents of all system parameter registers (SPRMs).

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.

GetButtonAtPosition

Retrieves the button located at the specified point within the display window.

GetButtonRect

Retrieves the rectangle coordinates of the specified button.

GetCmdFromEvent

Retrieves an IDvdCmd object from an EC_DVD_CMD_START, EC_DVD_CMD_END, or VFW_E_DVD_CMD_CANCELLED event.

GetCurrentAngle

Retrieves the number of available angles in the current angle block and the currently selected angle number.

GetCurrentAudio

Retrieves the number of available audio streams and the number of the currently selected audio stream.

GetCurrentButton

Retrieves the number of available buttons and the number of the currently selected button.

GetCurrentDomain

Retrieves the DVD domain in which the DVD Navigator is currently located.

GetCurrentLocation

Retrieves the current playback location.

GetCurrentSubpicture

Retrieves the number of available subpicture streams in the current title, the currently selected subpicture stream number, and the state of the subpicture.

GetCurrentUOPS

Retrieves a set of flags indicating which navigation commands, if any, the content authors have explicitly disabled for the current disc location.

GetCurrentVideoAttributes

Retrieves the video attributes of the current title or menu.

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.

GetDefaultMenuLanguage

Retrieves the default menu language.

GetDefaultSubpictureLanguage

Retrieves the default subpicture language.

GetDiscID

Retrieves a system-generated 64-bit "unique" identification number for the specified DVD.

GetDVDDirectory

Retrieves the root directory that is set in the DVD Navigator.

GetDVDTextLanguageInfo

Retrieves the information for the specified text string language block.

GetDVDTextNumberOfLanguages

Retrieves the number of text languages for the current DVD or disc side.

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™.

GetDVDVolumeInfo

Retrieves the current DVD volume information.

GetKaraokeAttributes

Retrieves the karaoke attributes of the specified audio stream in the current title or menu.

GetMenuLanguages

Retrieves all the languages available for all menus on the disc.

GetNumberOfChapters

Retrieves the number of chapters in a given title.

GetPlayerParentalLevel

Retrieves the current parental level and ISO 3166 country/region code settings for the DVD Navigator.

GetState

Retrieves a bookmark containing the disc location and DVD Navigator state information.

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.

GetTitleAttributes

Retrieves attributes of all video, audio, and subpicture streams for the specified title and its menus.

GetTitleParentalLevels

Retrieves the parental levels that are defined for a particular title.

GetTotalTitleTime

Retrieves the total playback time for the current title.

GetVMGAttributes

Retrieves attributes of all video, audio, and subpicture streams for the video manager menu.

IsAudioStreamEnabled

Determines if the specified audio stream is enabled in the current title.

IsSubpictureStreamEnabled

Determines if the specified subpicture stream is enabled in the current title.

 

Requirements

Minimum supported client

Windows XP [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2003 [desktop apps | Windows Store apps]

Header

Strmif.h (include Dshow.h)

Library

Strmiids.lib

See also

DVD Applications

 

 

Show: