IDvdControl2 interface (strmif.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
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.
Inheritance
The IDvdControl2 interface inherits from the IUnknown interface. IDvdControl2 also has these types of members:
Methods
The IDvdControl2 interface has these methods.
| IDvdControl2::AcceptParentalLevelChange The AcceptParentalLevelChange method accepts or rejects a request from the DVD Navigator to play content at a higher parental management level. |
| IDvdControl2::ActivateAtPosition The ActivateAtPosition method activates the menu button under the mouse pointer position. |
| IDvdControl2::ActivateButton The ActivateButton method activates the currently selected menu button. |
| IDvdControl2::Pause Note This method is deprecated. Applications should call IMediaControl::Pause instead. For more information, see Data Flow in the DVD Navigator. The Pause method pauses or resumes playback at the current location. |
| IDvdControl2::PlayAtTime The PlayAtTime method starts playback from the specified time in the current title. |
| IDvdControl2::PlayAtTimeInTitle The PlayAtTimeInTitle method starts playback from the specified time in the specified title. |
| IDvdControl2::PlayBackwards The PlayBackwards method plays backward at the specified speed from the current location. |
| IDvdControl2::PlayChapter The PlayChapter method starts playback from the specified chapter in the current title. |
| IDvdControl2::PlayChapterInTitle The PlayChapterInTitle method starts playback from the beginning of the specified chapter of the specified title. |
| IDvdControl2::PlayChaptersAutoStop The PlayChaptersAutoStop method plays the number of chapters specified, starting at the specified chapter within the specified title. |
| IDvdControl2::PlayForwards The PlayForwards method plays forward at the specified speed from the current location. |
| IDvdControl2::PlayNextChapter The PlayNextChapter method starts playback from the beginning of the next chapter in the current title. |
| IDvdControl2::PlayPeriodInTitleAutoStop The PlayPeriodInTitleAutoStop method starts playback in the specified title from the specified start time until the specified end time. |
| IDvdControl2::PlayPrevChapter The PlayPrevChapter method starts playback from the beginning of the previous chapter in the current title. |
| IDvdControl2::PlayTitle The PlayTitle method starts playback from the beginning of the specified title. |
| IDvdControl2::ReplayChapter The ReplayChapter method starts playback from the beginning of the current chapter. |
| IDvdControl2::Resume The Resume method leaves a menu and resumes playback. |
| IDvdControl2::ReturnFromSubmenu The ReturnFromSubmenu method returns the display from a submenu to its parent menu. |
| IDvdControl2::SelectAndActivateButton The SelectAndActivateButton method selects and activates the specified menu button. |
| IDvdControl2::SelectAngle The SelectAngle method sets the new angle when the DVD Navigator is in an angle block. |
| IDvdControl2::SelectAtPosition The SelectAtPosition method highlights the menu button under the mouse pointer position. |
| IDvdControl2::SelectAudioStream The SelectAudioStream method selects the audio stream to play. |
| IDvdControl2::SelectButton The SelectButton method selects the specified menu button. |
| IDvdControl2::SelectDefaultAudioLanguage The SelectDefaultAudioLanguage method sets the default audio language. |
| IDvdControl2::SelectDefaultMenuLanguage The SelectDefaultMenuLanguage method sets the default language for all menus and menu buttons. |
| IDvdControl2::SelectDefaultSubpictureLanguage The SelectDefaultSubpictureLanguage method sets the default language for subpicture text. |
| IDvdControl2::SelectKaraokeAudioPresentationMode The SelectKaraokeAudioPresentationMode method sends karaoke auxiliary channels to the left or right speakers. |
| IDvdControl2::SelectParentalCountry The SelectParentalCountry method sets the country/region for interpreting parental access levels and setting default languages. |
| IDvdControl2::SelectParentalLevel The SelectParentalLevel method sets the parental access level for the logged-on user. |
| IDvdControl2::SelectRelativeButton The SelectRelativeButton method sets the specified relative button (upper, lower, right, or left). |
| IDvdControl2::SelectSubpictureStream The SelectSubpictureStream method sets the subpicture stream to display. |
| IDvdControl2::SelectVideoModePreference The SelectVideoModePreference method sets the specified video mode display (wide screen, letterbox, or pan-scan) for playback. |
| IDvdControl2::SetDVDDirectory The SetDVDDirectory method sets the DVD drive that the DVD Navigator filter will read from. |
| IDvdControl2::SetGPRM The SetGPRM method sets a general parameter register value. |
| IDvdControl2::SetOption The SetOption method enables or disables an internal behavior flag on the DVD Navigator filter. |
| IDvdControl2::SetState The SetState method saves the current disc position and state of the DVD Navigator filter. |
| IDvdControl2::SetSubpictureState The SetSubpictureState method turns the subpicture display on or off. |
| IDvdControl2::ShowMenu The ShowMenu method displays the specified menu, if available. |
| IDvdControl2::StillOff The StillOff method resumes playback, canceling still mode. |
| IDvdControl2::Stop The Stop method stops playback of a title or menu by moving the DVD Navigator into the DVD Stop domain. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2003 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |