Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
| Microsoft DirectShow 9.0 |
IDvdControl2 Interface
The IDvdControl2 interface navigates and plays DVD-Video titles. The DirectShow DVD Navigator source filter implements this interface. 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 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. (Deprecated.) |
| 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. |
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also