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.
Members
The IDvdControl2 interface inherits from the IUnknown interface. IDvdControl2 also has these types of members:
Methods
The IDvdControl2 interface has these methods.
| Method | Description |
|---|---|
| AcceptParentalLevelChange |
Accepts or rejects a request from the DVD Navigator to play content at a higher parental management level. |
| ActivateAtPosition |
Activates the menu button under the mouse pointer position. |
| ActivateButton |
Activates the selected menu button. |
| 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. |
| Resume |
Leaves a menu and resumes playback. |
| ReturnFromSubmenu |
Returns the display from a submenu to its parent menu. |
| SelectAndActivateButton |
Selects and activates the specified menu button. |
| SelectAngle |
Sets the new angle when the DVD Navigator is in an angle block. |
| SelectAtPosition |
Highlights the menu button under the mouse pointer position. |
| SelectAudioStream |
Selects the audio stream to play. |
| SelectButton |
Selects the specified menu button. |
| SelectDefaultAudioLanguage |
Sets the default audio language. |
| SelectDefaultMenuLanguage |
Sets the default language for all menus and menu buttons. |
| SelectDefaultSubpictureLanguage |
Sets the default language for subpicture text. |
| SelectKaraokeAudioPresentationMode |
Sends karaoke auxiliary channels to the left or right speaker. |
| 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. |
| SelectRelativeButton |
Selects the specified relative button (upper, lower, right, left). |
| SelectSubpictureStream |
Sets the subpicture stream to display. |
| SelectVideoModePreference |
Sets the video mode display for subsequent playback—wide screen, letterbox, or pan-scan. |
| SetDVDDirectory |
Sets the DVD drive that the DVD Navigator will read from. |
| SetGPRM |
Sets a general parameter register value. |
| 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. |
| SetSubpictureState |
Turns the subpicture display on or off. |
| ShowMenu |
Displays the specified menu, if available. |
| StillOff |
Resumes playback, canceling still mode. |
| Stop |
Stops playback of a title or menu by moving the DVD Navigator into the DVD Stop domain. |
Requirements
|
Minimum supported client |
Windows XP [desktop apps | Windows Store apps] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps | Windows Store apps] |
|
Header |
|
|
Library |
|
See also