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.