Microsoft DirectX 8.1 (C++)

IDvdControl2 Interface

The DirectShow DVD Navigator source filter exposes the IDvdControl2 interface to enable applications to navigate and play DVD-Video titles, including karaoke titles. After creating a DVD filter graph through the IDvdGraphBuilder interface, a DVD player application uses the methods of the IDvdControl2 and IDvdInfo2 interfaces to send DVD commands to and retrieve state information from the DVD Navigator.

IDvdControl2 is a significant improvement over the older DVD control interface, IDvdControl. The new interface does not inherit from the old one; it encapsulates a completely new implementation. IDvdControl2 provides the full functionality required by the DVD Annex J specification, as well as methods for playback, menu navigation, and parental control.

For more information on writing a DVD player application using the DVD Navigator, including topics on the DVD filter graph, command synchronization, parental controls, menus, and karaoke support, see DVD Applications.

In addition to the methods inherited from IUnknown, the IDvdControl2 interface exposes the following methods. The methods are grouped by functional area.

Playback

Method	Description
Pause	Pauses or resumes playback at the current location.
PlayAtTime	Starts playback from the specified time in the current title.
PlayAtTimeInTitle	Starts playback from the specified time in the specified title.
PlayBackwards	Plays backward at the specified speed from the current location.
PlayChapter	Starts playback from the specified chapter in the current title.
PlayChapterInTitle	Starts playback from the beginning of the specified chapter of the specified title.
PlayChaptersAutoStop	Plays the number of chapters specified, starting at the specified chapter within the specified title.
PlayForwards	Plays forward at the specified speed from the current location.
PlayNextChapter	Starts playback from the beginning of the next chapter in the current title.
PlayPeriodInTitleAutoStop	Starts playback in the specified title from the specified start time until the specified end time.
PlayPrevChapter	Starts playback from the beginning of the previous chapter in the current title.
PlayTitle	Starts playback from the beginning of the specified title.
ReplayChapter	Starts playback from the beginning of the current chapter.
Stop	Stops playback of a title or menu by moving the DVD Navigator into the DVD Stop domain.

Menus

Method	Description
ActivateAtPosition	Activates the menu button under the mouse pointer position.
ActivateButton	Activates the selected menu button.
Resume	Leaves a menu and resumes playback.
ReturnFromSubmenu	Returns the display from a submenu to its parent menu.
SelectAtPosition	Highlights the menu button under the mouse pointer position.
SelectAndActivateButton	Selects and activates the specified menu button.
SelectButton	Selects the specified menu button.
SelectDefaultMenuLanguage	Sets the default language for all menus and menu buttons.
SelectRelativeButton	Selects the specified relative button (upper, lower, right, left).
ShowMenu	Displays the specified menu, if available.

Video Stream

Method	Description
SelectAngle	Sets the new angle when the DVD Navigator is in an angle block.
StillOff	Resumes playback, canceling still mode.
SelectVideoModePreference	Sets the video mode display for subsequent playback—wide screen, letterbox, or pan-scan.

Audio Stream

Method	Description
SelectAudioStream	Selects the audio stream to play.
SelectDefaultAudioLanguage	Sets the default audio language.
SelectKaraokeAudioPresentationMode	Sends karaoke auxiliary channels to the left or right speaker.

Subpicture Stream

Method	Description
SelectDefaultSubpictureLanguage	Sets the default language for subpicture text.
SelectSubpictureStream	Sets the subpicture stream to display.
SetSubpictureState	Turns the subpicture display on or off.

Parental Levels

Method	Description
AcceptParentalLevelChange	Accepts or rejects a request from the DVD Navigator to play content at a higher parental management level.
SelectParentalCountry	Sets the country/region for interpreting parental access levels and setting default languages.
SelectParentalLevel	Sets the parental access level for the logged-on user.

DVD Navigator Control

Method	Description
SetDVDDirectory	Sets the DVD drive that the DVD Navigator will read from.
SetOption	Enables or disables a DVD Navigator internal behavioral flag.
SetState	Saves the current disc position and state of the DVD Navigator for retrieval at a later time.
SetGPRM	Sets a general parameter register value.