summaryrefslogtreecommitdiffstats
path: root/dxsdk/Include/DShowIDL/dvdif.idl
diff options
context:
space:
mode:
Diffstat (limited to 'dxsdk/Include/DShowIDL/dvdif.idl')
-rw-r--r--dxsdk/Include/DShowIDL/dvdif.idl2326
1 files changed, 2326 insertions, 0 deletions
diff --git a/dxsdk/Include/DShowIDL/dvdif.idl b/dxsdk/Include/DShowIDL/dvdif.idl
new file mode 100644
index 00000000..4ad2bca1
--- /dev/null
+++ b/dxsdk/Include/DShowIDL/dvdif.idl
@@ -0,0 +1,2326 @@
+//------------------------------------------------------------------------------
+// File: DVDIf.idl
+//
+// Desc: DirectShow interfaces to control playback of a DVD filter graph.
+//
+// Copyright (c) 1992-2002, Microsoft Corporation. All rights reserved.
+//------------------------------------------------------------------------------
+
+
+// forward declarations - these are the interfaces declared in this file
+
+import "unknwn.idl";
+import "objidl.idl";
+
+cpp_quote("#include <ddraw.h>")
+
+interface IDvdControl;
+interface IDvdInfo;
+interface IDirectDraw;
+interface IDirectDrawSurface;
+interface IDvdGraphBuilder ;
+interface IDDrawExclModeVideo;
+interface IDDrawExclModeVideoCallback;
+interface IDvdCmd;
+interface IDvdState;
+
+
+//==========================================================================
+//==========================================================================
+//
+// typedefs used by IDvdControl and IDvdInfo interfaces.
+//
+//==========================================================================
+//==========================================================================
+
+typedef enum tagDVD_DOMAIN {
+ // The DVD_DOMAIN is used to indicate the stat of a DVD player.
+ DVD_DOMAIN_FirstPlay=1, // doing default initialization of a dvd disc
+ DVD_DOMAIN_VideoManagerMenu, // displaying menus for whole disc
+ DVD_DOMAIN_VideoTitleSetMenu, // displaying menus for current title set
+ DVD_DOMAIN_Title, // displaying current title
+ DVD_DOMAIN_Stop // player is in stopped state
+} DVD_DOMAIN;
+
+typedef enum tagDVD_MENU_ID {
+ DVD_MENU_Title = 2, // to choose a title from any VTS in a DVD-Video volume
+ DVD_MENU_Root = 3, // main menu for a specific VTS
+ DVD_MENU_Subpicture =4, // to choose subpicture stream in a VTS
+ DVD_MENU_Audio = 5, // to choose audio stream in a VTS
+ DVD_MENU_Angle = 6, // to choose angle num in a VTS
+ DVD_MENU_Chapter = 7 // to choose a chapter in a VTS
+ // the Root menu always provides a means of getting to to Subpicture, Audio,
+ // Angle and Chapter menus if they exist.
+} DVD_MENU_ID;
+
+typedef enum tagDVD_DISC_SIDE {
+ DVD_SIDE_A = 1,
+ DVD_SIDE_B = 2
+} DVD_DISC_SIDE;
+
+
+typedef enum tagDVD_PREFERRED_DISPLAY_MODE
+{
+ // DVD_PREFERRED_DISPLAY_MODE is used to indicate the user's
+ // preferred window aspect ratio and preferred method of converion of
+ // 16*9 content to a 4*3 window aspect ratio. Pan-scan and letterboxing are
+ // the two conversion methods. This enum is used to indicate only a preference of
+ // conversion mechinism since some content can only be converted using one
+ // of these methods. 4*3 content is converted to a 16*9 window always by using
+ // "reverse" letterboxing where black bars are added to the right and left
+ // sides of the display instead of the top and bottom of the display as in the 16*9
+ // to 4*3 conversion useing letterboxing.
+ DISPLAY_CONTENT_DEFAULT = 0, // default to content
+ DISPLAY_16x9 = 1, // 16x9 display
+ DISPLAY_4x3_PANSCAN_PREFERRED = 2, // 4x3 display with pan-scan preferrence
+ DISPLAY_4x3_LETTERBOX_PREFERRED = 3 // 4x3 display with letterbox preferrence
+
+} DVD_PREFERRED_DISPLAY_MODE;
+
+typedef WORD DVD_REGISTER;
+typedef DVD_REGISTER GPRMARRAY[16]; // DVD-Video 1.0 has 16 16-bit General Parameter Registers
+typedef DVD_REGISTER SPRMARRAY[24]; // DVD-Video 1.0 has 24 16-bit System Parameter Registers
+
+
+
+// these are only for IDVDInfo1 compatibility and require the DVD-Video 1.0 specification
+// Please use the IDVDInfo2's DVD_Title/MenuAttributes, DVD_VideoAttributes, DVD_AudioAttributes, and DVD_SubpictureAttributes
+typedef struct tagDVD_ATR
+{
+ //
+ // Refer to the DVD-Video 1.0 spec to parse these structures.
+ //
+ ULONG ulCAT; // VMG_CAT if this is for a volume; or VTS_CAT
+ // if this is for a Video Title Set (VTS)
+ BYTE pbATRI[768];// All stream attributes for menu and title from bytes
+ // 256 to 1023 of VMGI or VTSI.
+} DVD_ATR;
+typedef BYTE DVD_VideoATR[2]; // video stream attributes.
+typedef BYTE DVD_AudioATR[8]; // audio stream attributes.
+typedef BYTE DVD_SubpictureATR[6]; // subpicture stream attributes.
+
+// DVD1.0 Timecode is BCD encoded in this format: 0xHhMmSsFf, where
+// H is tens of hours
+// h is hours
+// M is tens of minutes
+// m is minutes
+// S is tens of seconds
+// s is seconds
+// F is tens of frames
+// f is frames
+// Note that you must know the frame rate to interperate the frame count as time.
+typedef enum tagDVD_FRAMERATE
+{
+ DVD_FPS_25 =1, // 25 frames per second
+ DVD_FPS_30NonDrop = 3 // exactly 30 frames per second
+} DVD_FRAMERATE;
+
+cpp_quote("typedef struct tagDVD_TIMECODE")
+cpp_quote("{")
+cpp_quote(" ULONG Hours1 :4; // Hours")
+cpp_quote(" ULONG Hours10 :4; // Tens of Hours ")
+cpp_quote("")
+cpp_quote(" ULONG Minutes1 :4; // Minutes ")
+cpp_quote(" ULONG Minutes10:4; // Tens of Minutes ")
+cpp_quote("")
+cpp_quote(" ULONG Seconds1 :4; // Seconds ")
+cpp_quote(" ULONG Seconds10:4; // Tens of Seconds ")
+cpp_quote("")
+cpp_quote(" ULONG Frames1 :4; // Frames ")
+cpp_quote(" ULONG Frames10 :2; // Tens of Frames ")
+cpp_quote("")
+cpp_quote(" ULONG FrameRateCode: 2; // use DVD_FRAMERATE to indicate frames/sec and drop/non-drop")
+cpp_quote("} DVD_TIMECODE;")
+
+//
+// Newer IDVD2 methods can use the HMSF format instead
+// Call SetOption( DVD_HMSF_TimeCodeEvents, TRUE) to return EC_DVD_CURRENT_HMSF_TIME
+// instead of EC_DVD_CURRENT_TIME events
+//
+typedef enum tagDVD_TIMECODE_FLAGS
+{
+ DVD_TC_FLAG_25fps = 0x00000001, // 25 frames per second
+ DVD_TC_FLAG_30fps = 0x00000002, // 30 frames per second
+ DVD_TC_FLAG_DropFrame = 0x00000004, // 29.97 instead of 30 fps
+ DVD_TC_FLAG_Interpolated = 0x00000008, // timecode may be inaccurate
+ // remainder of bits are reserved and should not be read
+} DVD_TIMECODE_FLAGS;
+
+// this can be cast to/from a ULONG
+typedef struct tagDVD_HMSF_TIMECODE
+{
+ BYTE bHours;
+ BYTE bMinutes;
+ BYTE bSeconds;
+ BYTE bFrames;
+} DVD_HMSF_TIMECODE;
+
+typedef struct tagDVD_PLAYBACK_LOCATION2
+{
+ //
+ // TitleNum & ChapterNum or TitleNum & TimeCode are sufficient to save
+ // playback location for One_Sequential_PGC_Titles.
+ //
+ ULONG TitleNum; // title number for whole disc (TTN not VTS_TTN)
+ ULONG ChapterNum; // part-of-title number with title. 0xffffffff if not Once_Sequential_PGC_Title
+ DVD_HMSF_TIMECODE TimeCode; // use DVD_TIMECODE for current playback time.
+ ULONG TimeCodeFlags; // union of DVD_TIMECODE_EVENT_FLAGS
+
+} DVD_PLAYBACK_LOCATION2;
+
+typedef struct tagDVD_PLAYBACK_LOCATION
+{
+ //
+ // TitleNum & ChapterNum or TitleNum & TimeCode are sufficient to save
+ // playback location for One_Sequential_PGC_Titles.
+ //
+ ULONG TitleNum; // title number for whole disc (TTN not VTS_TTN)
+ ULONG ChapterNum; // part-of-title number with title. 0xffffffff if not Once_Sequential_PGC_Title
+ ULONG TimeCode; // use DVD_TIMECODE for current playback time. 0xffffffff if not Once_Sequential_PGC_Title
+
+} DVD_PLAYBACK_LOCATION;
+
+typedef DWORD VALID_UOP_SOMTHING_OR_OTHER;
+
+typedef enum {
+ //
+ // Annex J User Functions ---
+ //
+ UOP_FLAG_Play_Title_Or_AtTime = 0x00000001, // Title_Or_Time_Play
+ UOP_FLAG_Play_Chapter = 0x00000002, // Chapter_Search_Or_Play
+ UOP_FLAG_Play_Title = 0x00000004, // Title_Play
+ UOP_FLAG_Stop = 0x00000008, // Stop
+ UOP_FLAG_ReturnFromSubMenu = 0x00000010, // GoUp
+ UOP_FLAG_Play_Chapter_Or_AtTime = 0x00000020, // Time_Or_Chapter_Search
+ UOP_FLAG_PlayPrev_Or_Replay_Chapter = 0x00000040, // Prev_Or_Top_PG_Search
+ UOP_FLAG_PlayNext_Chapter = 0x00000080, // Next_PG_Search
+ UOP_FLAG_Play_Forwards = 0x00000100, // Forward_Scan
+ UOP_FLAG_Play_Backwards = 0x00000200, // Backward_Scan
+ UOP_FLAG_ShowMenu_Title = 0x00000400, // Title_Menu_Call
+ UOP_FLAG_ShowMenu_Root = 0x00000800, // Root_Menu_Call
+ UOP_FLAG_ShowMenu_SubPic = 0x00001000, // SubPic_Menu_Call
+ UOP_FLAG_ShowMenu_Audio = 0x00002000, // Audio_Menu_Call
+ UOP_FLAG_ShowMenu_Angle = 0x00004000, // Angle_Menu_Call
+ UOP_FLAG_ShowMenu_Chapter = 0x00008000, // Chapter_Menu_Call
+ UOP_FLAG_Resume = 0x00010000, // Resume
+ UOP_FLAG_Select_Or_Activate_Button = 0x00020000, // Button_Select_Or_Activate
+ UOP_FLAG_Still_Off = 0x00040000, // Still_Off
+ UOP_FLAG_Pause_On = 0x00080000, // Pause_On
+ UOP_FLAG_Select_Audio_Stream = 0x00100000, // Audio_Stream_Change
+ UOP_FLAG_Select_SubPic_Stream = 0x00200000, // SubPic_Stream_Change
+ UOP_FLAG_Select_Angle = 0x00400000, // Angle_Change
+ UOP_FLAG_Select_Karaoke_Audio_Presentation_Mode = 0x00800000, // Karaoke_Audio_Pres_Mode_Change
+ UOP_FLAG_Select_Video_Mode_Preference = 0x01000000 // Video_Pres_Mode_Change
+} VALID_UOP_FLAG ;
+
+typedef enum {
+ DVD_CMD_FLAG_None = 0x00000000,
+ DVD_CMD_FLAG_Flush = 0x00000001,
+ DVD_CMD_FLAG_SendEvents = 0x00000002,
+ DVD_CMD_FLAG_Block = 0x00000004, // block end
+ DVD_CMD_FLAG_StartWhenRendered = 0x00000008, // command "start" when the first frame is rendered
+ DVD_CMD_FLAG_EndAfterRendered = 0x00000010, // command "ends" after the last frame is rendered
+} DVD_CMD_FLAGS;
+
+// For IDVDControl2::SetOption flags
+typedef enum {
+ DVD_ResetOnStop = 1, // default TRUE
+ DVD_NotifyParentalLevelChange = 2, // default FALSE
+ DVD_HMSF_TimeCodeEvents = 3, // default FALSE (send DVD_CURRENT_TIME events)
+ DVD_AudioDuringFFwdRew = 4 // default FALSE (or by reg)
+} DVD_OPTION_FLAG;
+
+typedef enum {
+ DVD_Relative_Upper = 1,
+ DVD_Relative_Lower = 2,
+ DVD_Relative_Left = 3,
+ DVD_Relative_Right = 4
+} DVD_RELATIVE_BUTTON;
+
+// Parental Level Information
+typedef enum tagDVD_PARENTAL_LEVEL
+{
+ DVD_PARENTAL_LEVEL_8 = 0x8000,
+ DVD_PARENTAL_LEVEL_7 = 0x4000,
+ DVD_PARENTAL_LEVEL_6 = 0x2000,
+ DVD_PARENTAL_LEVEL_5 = 0x1000,
+ DVD_PARENTAL_LEVEL_4 = 0x0800,
+ DVD_PARENTAL_LEVEL_3 = 0x0400,
+ DVD_PARENTAL_LEVEL_2 = 0x0200,
+ DVD_PARENTAL_LEVEL_1 = 0x0100
+} DVD_PARENTAL_LEVEL;
+
+
+typedef enum tagDVD_AUDIO_LANG_EXT
+{
+ DVD_AUD_EXT_NotSpecified =0,
+ DVD_AUD_EXT_Captions =1,
+ DVD_AUD_EXT_VisuallyImpaired =2,
+ DVD_AUD_EXT_DirectorComments1 =3,
+ DVD_AUD_EXT_DirectorComments2 =4,
+} DVD_AUDIO_LANG_EXT;
+
+typedef enum tagDVD_SUBPICTURE_LANG_EXT
+{
+ DVD_SP_EXT_NotSpecified =0,
+ DVD_SP_EXT_Caption_Normal =1,
+ DVD_SP_EXT_Caption_Big =2,
+ DVD_SP_EXT_Caption_Children =3,
+ DVD_SP_EXT_CC_Normal =5,
+ DVD_SP_EXT_CC_Big =6,
+ DVD_SP_EXT_CC_Children =7,
+ DVD_SP_EXT_Forced =9,
+ DVD_SP_EXT_DirectorComments_Normal =13,
+ DVD_SP_EXT_DirectorComments_Big =14,
+ DVD_SP_EXT_DirectorComments_Children =15,
+} DVD_SUBPICTURE_LANG_EXT;
+
+typedef enum tagDVD_AUDIO_APPMODE
+{
+ DVD_AudioMode_None = 0, // no special mode
+ DVD_AudioMode_Karaoke = 1,
+ DVD_AudioMode_Surround = 2,
+ DVD_AudioMode_Other = 3,
+} DVD_AUDIO_APPMODE;
+
+typedef enum tagDVD_AUDIO_FORMAT
+{
+ DVD_AudioFormat_AC3 = 0,
+ DVD_AudioFormat_MPEG1 = 1,
+ DVD_AudioFormat_MPEG1_DRC = 2, // MPEG1 with dynamic range control
+ DVD_AudioFormat_MPEG2 = 3,
+ DVD_AudioFormat_MPEG2_DRC = 4, // MPEG2 with dynamic range control
+ DVD_AudioFormat_LPCM = 5,
+ DVD_AudioFormat_DTS = 6,
+ DVD_AudioFormat_SDDS = 7,
+ DVD_AudioFormat_Other = 8
+} DVD_AUDIO_FORMAT;
+
+// flags for SelectKaraokeAudioPresentationMode
+typedef enum tagDVD_KARAOKE_DOWNMIX
+{
+ DVD_Mix_0to0 = 0x0001, // unused - reserved for future use
+ DVD_Mix_1to0 = 0x0002, // unused - reserved for future use
+ DVD_Mix_2to0 = 0x0004,
+ DVD_Mix_3to0 = 0x0008,
+ DVD_Mix_4to0 = 0x0010,
+ DVD_Mix_Lto0 = 0x0020, // mix auxillary L to channel 0 (left speaker)
+ DVD_Mix_Rto0 = 0x0040, // mix auxillary R to channel 0 (left speaker)
+
+ DVD_Mix_0to1 = 0x0100, // unused - reserved for future use
+ DVD_Mix_1to1 = 0x0200, // unused - reserved for future use
+ DVD_Mix_2to1 = 0x0400,
+ DVD_Mix_3to1 = 0x0800,
+ DVD_Mix_4to1 = 0x1000,
+ DVD_Mix_Lto1 = 0x2000, // mix auxillary L to channel 1 (right speaker)
+ DVD_Mix_Rto1 = 0x4000, // mix auxillary R to channel 1 (right speaker)
+} DVD_KARAOKE_DOWNMIX;
+
+
+typedef struct tagDVD_AudioAttributes
+{
+ DVD_AUDIO_APPMODE AppMode;
+ BYTE AppModeData;
+ DVD_AUDIO_FORMAT AudioFormat; // Use GetKaraokeAttributes()
+ LCID Language; // 0 if no language is present
+ DVD_AUDIO_LANG_EXT LanguageExtension; // (captions, if for children etc)
+ BOOL fHasMultichannelInfo; // multichannel attributes are present (Use GetMultiChannelAudioAttributes())
+ DWORD dwFrequency; // in hertz (48k, 96k)
+ BYTE bQuantization; // resolution (16, 20, 24 bits etc), 0 is unknown
+ BYTE bNumberOfChannels; // 5.1 AC3 has 6 channels
+ DWORD dwReserved[2];
+} DVD_AudioAttributes;
+
+typedef struct tagDVD_MUA_MixingInfo
+{
+ // surround sound mixing information applied when:
+ // AppMode = DVD_AudioMode_Surround
+ // AudioFormat = DVD_AudioFormat_LPCM,
+ // fHasMultichannelInfo=1 modes are all on
+ //
+ BOOL fMixTo0;
+ BOOL fMixTo1;
+
+ //
+ BOOL fMix0InPhase;
+ BOOL fMix1InPhase;
+
+ DWORD dwSpeakerPosition; // see ksmedia.h: SPEAKER_FRONT_LEFT, SPEAKER_FRONT_RIGHT, etc
+} DVD_MUA_MixingInfo;
+
+// The alpha coeff is used to mix to ACH0 and beta is used to mix to ACH1
+//
+// In general:
+// ACH0 = coeff[0].alpha * value[0] + coeff[1].alpha * value[1] + ...
+// ACH1 = coeff[0].beta * value[0] + coeff[1].beta * value[1] + ...
+typedef struct tagDVD_MUA_Coeff
+{
+ double log2_alpha; // actual coeff = 2^alpha
+ double log2_beta; // actual coeff = 2^beta
+} DVD_MUA_Coeff;
+
+typedef struct tagDVD_MultichannelAudioAttributes
+{
+ // actual Data for each data stream
+ DVD_MUA_MixingInfo Info[8];
+ DVD_MUA_Coeff Coeff[8];
+} DVD_MultichannelAudioAttributes;
+
+// bitwise OR of these flags descript the contents of each channel
+typedef enum tagDVD_KARAOKE_CONTENTS
+{
+ DVD_Karaoke_GuideVocal1 = 0x0001,
+ DVD_Karaoke_GuideVocal2 = 0x0002,
+ DVD_Karaoke_GuideMelody1 = 0x0004,
+ DVD_Karaoke_GuideMelody2 = 0x0008,
+ DVD_Karaoke_GuideMelodyA = 0x0010,
+ DVD_Karaoke_GuideMelodyB = 0x0020,
+ DVD_Karaoke_SoundEffectA = 0x0040,
+ DVD_Karaoke_SoundEffectB = 0x0080
+} DVD_KARAOKE_CONTENTS;
+
+typedef enum tagDVD_KARAOKE_ASSIGNMENT
+{
+ DVD_Assignment_reserved0 = 0,
+ DVD_Assignment_reserved1 = 1,
+ DVD_Assignment_LR = 2, // left right
+ DVD_Assignment_LRM = 3, // left right middle
+ DVD_Assignment_LR1 = 4, // left right audio1
+ DVD_Assignment_LRM1 = 5, // left right middle audio1
+ DVD_Assignment_LR12 = 6, // left right audio1 audio2
+ DVD_Assignment_LRM12 = 7 // left right middle audio1 audio2
+} DVD_KARAOKE_ASSIGNMENT;
+
+typedef struct tagDVD_KaraokeAttributes
+{
+ BYTE bVersion;
+ BOOL fMasterOfCeremoniesInGuideVocal1;
+ BOOL fDuet; // false = solo
+ DVD_KARAOKE_ASSIGNMENT ChannelAssignment;
+ WORD wChannelContents[8]; // logical OR of DVD_KARAOKE_CONTENTS
+} DVD_KaraokeAttributes;
+
+typedef enum tagDVD_VIDEO_COMPRESSION
+{
+ DVD_VideoCompression_Other = 0,
+ DVD_VideoCompression_MPEG1 = 1,
+ DVD_VideoCompression_MPEG2 = 2,
+} DVD_VIDEO_COMPRESSION;
+
+typedef struct tagDVD_VideoAttributes
+{
+ BOOL fPanscanPermitted; // if a 4x3 display, can be shown as PanScan
+ BOOL fLetterboxPermitted; // if a 4x3 display, can be shown as Letterbox
+ ULONG ulAspectX; // 4x3 or 16x9
+ ULONG ulAspectY;
+ ULONG ulFrameRate; // 50hz or 60hz
+ ULONG ulFrameHeight; // 525 (60hz) or 625 (50hz)
+ DVD_VIDEO_COMPRESSION Compression;// MPEG1 or MPEG2
+
+ BOOL fLine21Field1InGOP; // true if there is user data in field 1 of GOP of video stream
+ BOOL fLine21Field2InGOP; // true if there is user data in field 1 of GOP of video stream
+
+ ULONG ulSourceResolutionX; // X source resolution (352,704, or 720)
+ ULONG ulSourceResolutionY; // Y source resolution (240,480, 288 or 576)
+
+ BOOL fIsSourceLetterboxed; // subpictures and highlights (e.g. subtitles or menu buttons) are only
+ // displayed in the active video area and cannot be displayed in the top/bottom 'black' bars
+ BOOL fIsFilmMode; // for 625/50hz systems, is film mode (true) or camera mode (false)
+} DVD_VideoAttributes;
+
+typedef enum tagDVD_SUBPICTURE_TYPE
+{
+ DVD_SPType_NotSpecified = 0,
+ DVD_SPType_Language = 1,
+ DVD_SPType_Other = 2,
+} DVD_SUBPICTURE_TYPE;
+
+typedef enum tagDVD_SUBPICTURE_CODING
+{
+ DVD_SPCoding_RunLength = 0,
+ DVD_SPCoding_Extended = 1,
+ DVD_SPCoding_Other = 2,
+} DVD_SUBPICTURE_CODING;
+
+typedef struct tagDVD_SubpictureAttributes
+{
+ DVD_SUBPICTURE_TYPE Type;
+ DVD_SUBPICTURE_CODING CodingMode;
+ LCID Language;
+ DVD_SUBPICTURE_LANG_EXT LanguageExtension;
+} DVD_SubpictureAttributes;
+
+typedef enum tagDVD_TITLE_APPMODE
+{
+ DVD_AppMode_Not_Specified = 0, // no special mode
+ DVD_AppMode_Karaoke = 1,
+ DVD_AppMode_Other = 3,
+} DVD_TITLE_APPMODE;
+
+typedef struct tagDVD_TitleMainAttributes
+{
+ // for Titles
+ DVD_TITLE_APPMODE AppMode;
+
+ // Attributes about the 'main' video of the menu or title
+ DVD_VideoAttributes VideoAttributes;
+
+ ULONG ulNumberOfAudioStreams;
+ DVD_AudioAttributes AudioAttributes[8];
+ // present if the multichannel bit is set in the corresponding stream's audio attributes
+ DVD_MultichannelAudioAttributes MultichannelAudioAttributes[8];
+
+ ULONG ulNumberOfSubpictureStreams;
+ DVD_SubpictureAttributes SubpictureAttributes[32];
+} DVD_TitleAttributes;
+
+typedef struct tagDVD_MenuAttributes
+{
+ // for VMG only
+ BOOL fCompatibleRegion[8]; // indeces 0..7 correspond to regions 1..8
+
+ // Attributes about the main menu (VMGM or VTSM)
+ DVD_VideoAttributes VideoAttributes;
+
+ BOOL fAudioPresent;
+ DVD_AudioAttributes AudioAttributes;
+
+ BOOL fSubpicturePresent;
+ DVD_SubpictureAttributes SubpictureAttributes;
+} DVD_MenuAttributes;
+
+//==========================================================================
+//==========================================================================
+// IDvdControl interface -- Basic DVD-Video playback control.
+// This modeled after the app control of a player specified in Annex J
+// of the DVD Video spec. IDvdInfo can be used to get information useful
+// in using IDvdControl
+//==========================================================================
+//==========================================================================
+
+[
+object,
+uuid(A70EFE61-E2A3-11d0-A9BE-00AA0061BE93),
+pointer_default(unique)
+]
+
+interface IDvdControl : IUnknown {
+ import "unknwn.idl";
+
+ // TitlePlay
+ // Start playing the specified title number.
+ // Title numbers range between 1 and 99.
+ HRESULT TitlePlay
+ ( [in] ULONG ulTitle
+ );
+
+ // ChapterPlay
+ // Start playing at the specified chapter (or part-of-title)
+ // within the specified title. Chapters range from 1 to 999.
+ HRESULT ChapterPlay
+ ( [in] ULONG ulTitle,
+ [in] ULONG ulChapter
+ );
+
+ // TimePlay
+ // Start playing at the specified time within the specified title.
+ // NOTE: the actual start time will be the closest sync point before
+ // or equal to the specified frame number.
+ HRESULT TimePlay
+ ( [in] ULONG ulTitle,
+ [in] ULONG bcdTime // use DVD_TIMECODE. Framerate code is ignored.
+ );
+
+ // StopForResume
+ // Stop playback after saving resume information. DVD Navigator transfers to the DVD "Stop State" and
+ // (same as DVD_DOMAIN_Stop), but filter graph remains in DirectShow's Run state.
+ HRESULT StopForResume();
+
+ // GoUp
+ // Start playback of the program chain currently authored as the "GoUp_PGCN".
+ HRESULT GoUp();
+
+ // TimeSearch
+ // Start playing at the specified time within the current title.
+ // NOTE: the actual start time will be the closest sync point before
+ // or equal to the specified frame number.
+ HRESULT TimeSearch
+ ( [in] ULONG bcdTime // use DVD_TIMECODE. Framerate code is ignored.
+ );
+
+ // ChapterSearch
+ // Start playing at the specified chapter (or part-of-title) within
+ // the current title.
+ HRESULT ChapterSearch
+ ( [in] ULONG ulChapter
+ );
+
+ // PrevPGSearch
+ // Start playing at the beginning of the previous DVD "program".
+ // For One-Sequential_PGC_Titles (which includes most titles) a program
+ // is equivalent to a chapter, otherwise a program is part of a chapter.
+ HRESULT PrevPGSearch();
+
+ // TopPGSearch
+ // Start playing from the beginning of they current program.
+ HRESULT TopPGSearch();
+
+ // NextPGSearch
+ // Start playing from the beginning of the next program.
+ HRESULT NextPGSearch();
+
+ // ForwardScan
+ // Set forward play at the specified speed.
+ // dwSpeed == 1 is normal play
+ // dwSpeed < 1 is slow play
+ // dwSpeed > 1 is fast play
+ // For dwSpeed != 1, audio and subpicture is muted.
+ HRESULT ForwardScan
+ ( [in] double dwSpeed
+ );
+
+ // BackwardScan
+ // Set reverse play at the specified speed.
+ // dwSpeed == 1 is normal play speed in reverse
+ // dwSpeed < 1 is slow play in reverse
+ // dwSpeed > 1 is fast play in reverse
+ // For reverse play, audio and subpicture are always muted.
+ HRESULT BackwardScan
+ ( [in] double dwSpeed
+ );
+
+ // MenuCall
+ // Start playback of the Menu specified by an enum DVD_MENU_ID.
+ HRESULT MenuCall
+ ( [in] DVD_MENU_ID MenuID
+ );
+
+ // Resume
+ // Returns to title playback in DVD_DOMAIN_Title. This is typically
+ // done after MenuCall which puts the DVD Navigator in
+ // DVD_DOMAIN_VideoTitleSetMenu or DVD_DOMAIN_VideoManagerMenu.
+ HRESULT Resume();
+
+ // UpperButtonSelect
+ // Selects the button above the current button.
+ // "Selecting" a DVD button simply highlights the button but does
+ // not "Activate" the button. Selecting is the Windows equivalent
+ // to tabbing to a button but not pressing the space bar or enter key.
+ // Activating is the Windows equivalent of pressing the space bar or
+ // enter key after tabbing to a button.
+ HRESULT UpperButtonSelect();
+
+ // LowerButtonSelect
+ // Selects the button below the current button.
+ HRESULT LowerButtonSelect();
+
+ // LeftButtonSelect
+ // Selects the button to the left of the current button.
+ HRESULT LeftButtonSelect();
+
+ // RightButtonSelect
+ // Selects the button to the right of the current button.
+ HRESULT RightButtonSelect();
+
+ // ButtonActivate
+ // Activates current button.
+ HRESULT ButtonActivate();
+
+ // ButtonSelectAndActivate
+ // Selects and then activates the button specified by the user.
+ // ulButton is intended to be a number entered by a user corresponding
+ // to button numbers currently displayed on screen.
+ // Button numbers range from 1 to 36.
+ HRESULT ButtonSelectAndActivate
+ ( [in] ULONG ulButton
+ );
+
+ // StillOff
+ // Releases any current still if there are no available buttons.
+ // This includes VOBU stills, Cell stills, and PGC stills, whether the
+ // still is infinite. When buttons are available, stills are released by
+ // activating a button. Note this does not release a Pause.
+ HRESULT StillOff();
+
+ // PauseOn
+ // Freezes playback and any internal timers. This is similar to
+ // IMediaControl::Pause()
+ HRESULT PauseOn();
+
+ // PauseOff
+ // Releases a Pause.
+ HRESULT PauseOff();
+
+ // MenuLanguageSelect
+ // Selects the default language for menus. Languages are specified with
+ // Windows standard LCIDs. LCIDs can be created from ISO-639 codes with
+ // MAKELCID( MAKELANGID(wISO639LangID ,SUBLANG_DEFAULT ), SORT_DEFAULT )
+ // NOTE: MAKELANGID seems to have a bug so 'jp' may have to be used
+ // instead of 'ja' for the ISO639 code for Japanese.
+ // MenuLanguageSelect may only called from the DVD Stop state (DVD_DOMAIN_Stop).
+ HRESULT MenuLanguageSelect
+ ( [in] LCID Language
+ );
+
+ // AudioStreamChange
+ // Changes the current audio stream.
+ HRESULT AudioStreamChange
+ ( [in] ULONG ulAudio
+ );
+
+ // SubpictureStreamChange
+ // Changes the current subpicture stream number to nSubpic, and toggles
+ // its display.
+ HRESULT SubpictureStreamChange
+ ( [in] ULONG ulSubPicture,
+ [in] BOOL bDisplay
+ );
+
+ // AngleChange
+ // Changes the current angle number.
+ HRESULT AngleChange
+ ( [in] ULONG ulAngle
+ );
+
+ // ParentalLevelSelect
+ // Selects the current player parental level between 1 and 8. The
+ // defined parental levels are listed below :
+ //
+ // Level Rating
+ // ----- ------
+ //
+ // 1 G
+ // 3 PG
+ // 4 PG13
+ // 6 R
+ // 7 NC17
+ // Higher levels can play lower level content; lower levels cannot play
+ // higher level content. The DVD Navigator provides no restriction on
+ // setting the parental level. DVD player application may enforce
+ // restriction on parental level setting, such as password protection for
+ // raising the current parental level. Parental Management is disabled in
+ // the Navigator by default.
+ //
+ // Note : To disable parental management, pass 0xffffffff for ulParentalLevel
+ // If parental management is disabled, then the player will play the
+ // first PGC in a parental block regardless of parental IDs.
+ //
+ HRESULT ParentalLevelSelect
+ ( [in] ULONG ulParentalLevel
+ );
+
+ // ParentalCountrySelect
+ // Sets the country in which to interpret the the Parental Level.
+ // The country specified using the Alpha-2 code of the ISO-3166 standard,
+ // with the addition of 'ZZ'
+ HRESULT ParentalCountrySelect
+ ( [in] WORD wCountry
+ );
+
+ // KaraokeAudioPresentationModeChange
+ // Sets the Karaoke audio mode.
+ // NOTE: This and all other Karoke support is currently not implemented.
+ HRESULT KaraokeAudioPresentationModeChange
+ ( [in] ULONG ulMode
+ );
+
+ // VideoModePreferrence
+ // The user can specify the preferred display mode that should
+ // be used to display content. The parameter is a ULONG that has
+ // one of the values defined in DVD_PREFERRED_DISPLAY_MODE
+ HRESULT VideoModePreferrence
+ ( [in] ULONG ulPreferredDisplayMode
+ );
+
+ // SetRoot
+ // Sets the root directory containing the DVD-Video volume.
+ // Can only be called from the DVD Stop State (DVD_DOMAIN_Stop).
+ // If the root directory is not successfully set before
+ // IMediaControl::Play is called, the first drive starting from c:
+ // containing a VIDEO_TS directory in the top level directory
+ // will be used as the root.
+ HRESULT SetRoot
+ ( [in] LPCWSTR pszPath
+ );
+
+ // MouseActivate
+ // This is typically called in response to a mouse click.
+ // The specified point within the display window is to see if it is
+ // within a current DVD button's highlight rect. If it is, that
+ // button is first selected, then activated.
+ // NOTE: DVD Buttons do not all necessarily have highlight rects,
+ // button rects can overlap, and button rects do not always
+ // correspond to the visual representation of DVD buttons.
+ HRESULT MouseActivate // typically called after a mouse click
+ ( [in] POINT point
+ );
+
+ // MouseSelect
+ // This is typically called in response to a mouse move within the
+ // display window.
+ // The specified point within the display window is to see if it is
+ // within a current DVD button's highlight rect. If it is, that
+ // button is selected.
+ // NOTE: DVD Buttons do not all necessarily have highlight rects,
+ // button rects can overlap, and button rects do not always
+ // correspond to the visual representation of DVD buttons.
+ HRESULT MouseSelect // typically called after a mouse move
+ ( [in] POINT point
+ );
+
+ // ChapterPlayAutoStop
+ // Start playing at the specified chapter within the specified title
+ // and play the number of chapters specified by the third parameter.
+ // Chapters range from 1 to 999.
+ HRESULT ChapterPlayAutoStop
+ ( [in] ULONG ulTitle, // title number
+ [in] ULONG ulChapter, // chapter number to start playback
+ [in] ULONG ulChaptersToPlay // number of chapters to play from the start chapter
+ );
+}
+
+
+
+//==========================================================================
+//==========================================================================
+// IDvdInfo interface -- allow an app to query for attributes of available
+// DVD titles and DVD player status. Also allow for control of a DVD
+// player beyond Annex J in the DVD spec.
+//==========================================================================
+//==========================================================================
+
+[
+object,
+uuid(A70EFE60-E2A3-11d0-A9BE-00AA0061BE93),
+pointer_default(unique)
+]
+
+interface IDvdInfo : IUnknown {
+ import "unknwn.idl";
+
+ // GetCurrentDomain
+ // Returns the current DVD Domain of the DVD player.
+ HRESULT GetCurrentDomain
+ ( [out] DVD_DOMAIN *pDomain
+ );
+
+ // GetCurrentLocation
+ // Returns information sufficient to restart playback of a video
+ // from the current playback location in titles that don't explicitly
+ // disable seeking to the current location.
+ HRESULT GetCurrentLocation
+ ( [out] DVD_PLAYBACK_LOCATION *pLocation
+ );
+
+ // GetTotalTitleTime
+ // Return the total playback time for the current title. Only works
+ // for One_Sequential_PGC_Titles.
+ HRESULT GetTotalTitleTime
+ ( [out] ULONG * pulTotalTime // use DVD_TIMECODE.
+ );
+
+ // GetCurrentButton
+ // Indicates the number of currently available buttons and the current
+ // selected button number. If buttons are not present it returns 0 for
+ // both pulButtonsAvailable and pulCurrentButton
+ HRESULT GetCurrentButton
+ ( [out] ULONG * pulButtonsAvailable,
+ [out] ULONG * pulCurrentButton
+ );
+
+ // GetCurrentAngle
+ // Indicates the number of currently available angles and the current
+ // selected angle number. If *pnAnglesAvailable==1, then the current
+ // video is not multiangle.
+ HRESULT GetCurrentAngle
+ ( [out] ULONG * pulAnglesAvailable,
+ [out] ULONG * pulCurrentAngle
+ );
+
+ // GetCurrentAudio
+ // Indicates the number of currently available audio streams and
+ // the current selected audio stream number.
+ // This only work when in DVD_DOMAIN_Title.
+ HRESULT GetCurrentAudio
+ ( [out] ULONG * pulStreamsAvailable,
+ [out] ULONG * pulCurrentStream
+ );
+
+ // GetCurrentSubpicture
+ // Indicates the number of currently available subpicture streams,
+ // the current selected subpicture stream number, and if the
+ // subpicture display is currently disabled. Subpicture streams
+ // authored as Forcedly Activated stream will be displayed even if
+ // subpicture display has been disabled by the app with
+ // IDVDControl::SubpictureChangeStream.
+ // This only work when in DVD_DOMAIN_Title.
+ HRESULT GetCurrentSubpicture
+ ( [out] ULONG * pulStreamsAvailable,
+ [out] ULONG * pulCurrentStream,
+ [out] BOOL * pIsDisabled
+ );
+
+ // GetCurrentUOPS
+ // Indicates which IDVDControl methods are currently valid. DVD titles
+ // can enable or disable individual user operations at almost any point
+ // during playback.
+ HRESULT GetCurrentUOPS
+ ( [out] VALID_UOP_SOMTHING_OR_OTHER * pUOP
+ );
+
+ // GetAllSPRMs
+ // Returns the current contents of all System Parameter Registers.
+ // See DVD-Video spec for use of individual registers.
+ HRESULT GetAllSPRMs
+ ( [out] SPRMARRAY * pRegisterArray
+ );
+
+ // GetAllGPRMs
+ // Returns the current contents of all General Parameter Registers.
+ // Use of GPRMs is title specific.
+ HRESULT GetAllGPRMs
+ ( [out] GPRMARRAY * pRegisterArray
+ );
+
+ // GetAudioLanguage
+ // Returns the language of the specified stream within the current
+ // title. Does not return languages for menus. Sets *pLanguage=0 if
+ // if the stream does not include language.
+ // Use GetLocaleInfo(*pLanguage, LOCALE_SENGLANGUAGE, pszString, cbSize)
+ // to create a human readable string name from the result LCID.
+ HRESULT GetAudioLanguage
+ ( [in] ULONG ulStream,
+ [out] LCID * pLanguage
+ );
+
+ // GetSubpictureLanguage
+ // Returns the language of the specified stream within the current
+ // title. Does not return languages for menus. Sets *pLanguage=0 if
+ // if the stream does not include language.
+ // Use GetLocaleInfo(*pLanguage, LOCALE_SENGLANGUAGE, pszString, cbSize)
+ // to create a human readable string name from the result LCID.
+ HRESULT GetSubpictureLanguage
+ ( [in] ULONG ulStream,
+ [out] LCID * pLanguage
+ );
+
+ // GetTitleAttributes
+ // Returns attributes of all video, audio, and subpicture
+ // streams for the specified title including menus.
+ // If nTitle == 0xffffffff, attributes for the current title are returned.
+ HRESULT GetTitleAttributes
+ ( [in] ULONG ulTitle, // requested title number
+ [out] DVD_ATR * pATR
+ );
+
+ // GetVMGAttributes
+ // Returns attributes of all video, audio, and subpicture
+ // streams for Video Manager Menus. Some menus, such as the DVD_MENU_Title
+ // are in a separate group of streams called the VMG (Video Manager) and
+ // are not associated with any particular title number.
+ HRESULT GetVMGAttributes
+ ( [out] DVD_ATR * pATR
+ );
+
+ // GetCurrentVideoAttributes
+ // Returns the video attributes for the current title or menu.
+ HRESULT GetCurrentVideoAttributes
+ ( [out] DVD_VideoATR *pATR
+ );
+
+ // GetCurrentAudioAttributes
+ // Returns the video attributes for the stream in the current
+ // title or menu.
+ HRESULT GetCurrentAudioAttributes
+ ( [out] DVD_AudioATR *pATR
+ );
+
+ // GetCurrentSubpictureAttributes
+ // Returns the video attributes for the stream in the current
+ // title or menu.
+ HRESULT GetCurrentSubpictureAttributes
+ ( [out] DVD_SubpictureATR *pATR
+ );
+
+
+ // GetCurrentVolumeInfo
+ // Returns current DVD volume info.
+ HRESULT GetCurrentVolumeInfo
+ ( [out] ULONG *pulNumOfVol, // number of volumes (disc sides?) in a volume set
+ [out] ULONG *pulThisVolNum, // volume number for this root directory
+ [out] DVD_DISC_SIDE *pSide, // current disc side
+ [out] ULONG *pulNumOfTitles // number of titles available in this volume
+ );
+
+
+ // GetDVDTextInfo
+ // Returns the TXTDT_MG structure, which can contain text descriptions for title
+ // name, volume name, producer name, vocalist name, etc. in various languages.
+ // refer to Section 4.1.6 and Annex A of the DVD-Video spec.
+ // If the buffer size passed in is insufficient (for example if cbBufSize==0),
+ // then E_OUTOFMEMORY is returned, and *pcbActualSize is set to the required size.
+ HRESULT GetDVDTextInfo
+ ( [out, size_is(ulBufSize)] BYTE *pTextManager,
+ [in] ULONG ulBufSize, // buffer size passed in
+ [out] ULONG *pulActualSize // amount of actual data return
+ );
+
+ // GetPlayerParentalLevel
+ // Returns the current parental level and the current country code
+ // that has been set in the system registers in player.
+ // See Table 3.3.4-1 of the DVD-Video spec for the defined parental levels.
+ // Valid Parental Levels = 1..8 if parental management is enabled
+ // 0xffffffff if parental management is disabled
+ // See ISO3166 : Alpha-2 Code for the country codes.
+ HRESULT GetPlayerParentalLevel
+ ( [out] ULONG *pulParentalLevel, // current parental level
+ [out] ULONG *pulCountryCode // current country code
+ );
+
+ // GetNumberOfChapters
+ // Returns the number of chapters that are defined for a
+ // given title.
+ HRESULT GetNumberOfChapters
+ ( [in] ULONG ulTitle, // Title for which number of chapters is requested
+ [out] ULONG *pulNumberOfChapters // Number of chapters for the specified title
+ );
+
+ // GetTitleParentalLevels
+ // Returns the parental levels that are defined for a
+ // particular title. pParentalLevels will be combination
+ // of DVD_PARENTAL_LEVEL_8, DVD_PARENTAL_LEVEL_6, or
+ // DVD_PARENTAL_LEVEL_1 "OR"ed together
+ HRESULT GetTitleParentalLevels
+ ( [in] ULONG ulTitle, // Title for which parental levels are requested
+ [out] ULONG *pulParentalLevels // Parental levels defined for the title "OR"ed together
+ );
+
+ // GetRoot
+ // Returns the root directory that is set in the player. If a valid root
+ // has been found, it returns the root string. Otherwise, it returns 0 for
+ // pcbActualSize indicating that a valid root directory has not been found
+ // or initialized.
+ //
+ // !!! used to return LPTSTR. interface was changed to return
+ // LPSTR (ansi) for compatibility. COM APIs should pass with
+ // UNICODE strings only.
+ //
+ HRESULT GetRoot
+ ( [out, size_is(ulBufSize)] LPSTR pRoot, // pointer to buffer to get root string
+ [in] ULONG ulBufSize, // size of buffer passed in
+ [out] ULONG *pulActualSize // size of actual data returned
+ );
+}
+
+//==========================================================================
+//==========================================================================
+// IDvdCmd interface -- the IDVDControl2 command sequencing object.
+//
+// For the IDVDControl2 interface, the application can track the status of
+// commands that have been issued to the navigator. Each command is identified
+// by an IDvdCmd object. The IDvdCmd object stores the results of the command
+// at both the start (when the command has begun processing) and the end after
+// it has completed. It also allows the app to synchronize with the processing
+// of the command.
+//
+// The command object also allows the app to uniquely identify and correlate
+// completion events (if it prefers to process events in a message loop instead
+// of creating another process).
+//
+// Allows the app to track the status of an issued command to the nav.
+//==========================================================================
+//==========================================================================
+
+[
+object,
+uuid(5a4a97e4-94ee-4a55-9751-74b5643aa27d),
+pointer_default(unique)
+]
+
+interface IDvdCmd : IUnknown {
+ import "unknwn.idl";
+
+ //
+ // WaitForStart
+ //
+ // Blocks the application until the command has begun.
+ //
+ HRESULT WaitForStart();
+
+ //
+ // WaitForEnd
+ //
+ // Blocks until the command has completed or has been cancelled.
+ HRESULT WaitForEnd();
+}
+
+//==========================================================================
+//==========================================================================
+// IDvdState interface -- the State state object.
+//
+// Whenever the application wishes to save or restore a location on the disc,
+// it needs to store the DVD state into an object.
+// The State object supports the IPersistStream
+//
+//==========================================================================
+//==========================================================================
+
+[
+object,
+uuid(86303d6d-1c4a-4087-ab42-f711167048ef),
+pointer_default(unique)
+]
+
+interface IDvdState : IUnknown
+{
+ //
+ // GetDiscID
+ //
+ // Returns the disc ID from which the bookmark was made.
+ //
+ HRESULT GetDiscID
+ ( [out] ULONGLONG* pullUniqueID ); // 64-bit unique id for the disc
+
+ //
+ // GetParentalLevel
+ //
+ // Returns the state's parental level
+ //
+ HRESULT GetParentalLevel
+ ( [out] ULONG* pulParentalLevel );
+}
+
+//==========================================================================
+//==========================================================================
+// IDvdControl2 interface -- Basic DVD-Video playback control.
+// This is modeled after the app control of a player specified in Annex J
+// of the DVD Video spec. IDvdInfo2 can be used to get information useful
+// in using IDvdControl2
+//==========================================================================
+//==========================================================================
+
+[
+object,
+uuid(33BC7430-EEC0-11D2-8201-00A0C9D74842),
+pointer_default(unique)
+]
+
+interface IDvdControl2 : IUnknown {
+ import "unknwn.idl";
+
+ // PlayTitle
+ //
+ // Start playing from the beginning of the specified title number.
+ // Annex J: Title_Play
+ // Title numbers range between 1 and 99.
+ HRESULT PlayTitle
+ ( [in] ULONG ulTitle,
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+ );
+
+ // PlayChapterInTitle
+ //
+ // Start playing from the beginning of the given chapter (or part-of-title) number
+ // within the specified title number.
+ // Annex J: PTT_Play
+ // Title numbers range between 1 and 99.
+ // Chapters range from 1 to 999.
+ HRESULT PlayChapterInTitle
+ ( [in] ULONG ulTitle,
+ [in] ULONG ulChapter,
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+ );
+
+ // PlayAtTimeInTitle
+ //
+ // Start playing from the specified time within the specified title number.
+ // NOTE: the actual start time will be the closest sync point before
+ // or equal to the specified frame number.
+ // Annex J: Time_Play
+ // Title numbers range between 1 and 99.
+ HRESULT PlayAtTimeInTitle
+ ( [in] ULONG ulTitle,
+ [in] DVD_HMSF_TIMECODE* pStartTime,
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+ );
+
+ // Stop
+ // Stop playback by transferring DVD Navigator to the DVD "Stop State" (same
+ // as DVD_DOMAIN_Stop), but filter graph remains in DirectShow's Run state.
+ // Annex J: Stop
+ HRESULT Stop();
+
+ // ReturnFromSubmenu
+ //
+ // Stop playback of current program chain (PGC) and start playing the PGC
+ // specified by "GoUp_PGCN".in the PGCI.
+ // If the GoUp_PGCN value is 0xFFFF the Resume() operation is carried out.
+ // Annex J: GoUp
+ HRESULT ReturnFromSubmenu(
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd );
+
+ // PlayAtTime
+ // Start playing at the specified time within the current title.
+ // NOTE: the actual start time will be the closest sync point before
+ // or equal to the specified frame number.
+ // Annex J: Time_Search
+ // The time is in BCD format, passed in as a ULONG.
+ HRESULT PlayAtTime
+ ( [in] DVD_HMSF_TIMECODE* pTime,
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+ );
+
+ // PlayChapter
+ // Start playing at the specified chapter (or part-of-title) within
+ // the current title.
+ // Annex J: PTT_Search
+ // Chapters range from 1 to 999.
+ HRESULT PlayChapter
+ ( [in] ULONG ulChapter,
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+ );
+
+ // PlayPrevChapter
+ // Start playing at the beginning of the previous DVD "program".
+ // For One-Sequential_PGC_Titles (which includes most titles) a program
+ // is equivalent to a chapter, otherwise a program is part of a chapter.
+ // Annex J: PrevPG_Search
+ HRESULT PlayPrevChapter(
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd );
+
+ // ReplayChapter
+ // Start playing from the beginning of they current program.
+ // Annex J: TopPG_Search
+ HRESULT ReplayChapter(
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd );
+
+ // PlayNextChapter
+ // Start playing from the beginning of the next program.
+ // Annex J: NextPG_Search
+ HRESULT PlayNextChapter(
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd );
+
+ // PlayForwards
+ // Set forward play at the specified speed.
+ // Annex J: Forward_Scan
+ // dSpeed == 1 is normal play
+ // dSpeed < 1 is slow play
+ // dSpeed > 1 is fast play
+ // For dSpeed != 1, audio and subpicture is muted.
+ HRESULT PlayForwards
+ ( [in] double dSpeed,
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+ );
+
+ // PlayBackwards
+ // Set reverse play at the specified speed.
+ // Annex J: Backward_Scan
+ // dSpeed == 1 is normal play speed in reverse
+ // dSpeed < 1 is slow play in reverse
+ // dSpeed > 1 is fast play in reverse
+ // For reverse play, audio and subpicture are always muted.
+ HRESULT PlayBackwards
+ ( [in] double dSpeed,
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+ );
+
+ // ShowMenu
+ // Start playback of the Menu specified by an enum DVD_MENU_ID.
+ // Annex J: Menu_Call
+ HRESULT ShowMenu
+ ( [in] DVD_MENU_ID MenuID,
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+ );
+
+ // Resume
+ // Returns to title playback in DVD_DOMAIN_Title. This is typically
+ // done after MenuCall which puts the DVD Navigator in
+ // DVD_DOMAIN_VideoTitleSetMenu or DVD_DOMAIN_VideoManagerMenu.
+ // Annex J: Resume
+ HRESULT Resume(
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd );
+
+ // SelectRelativeButton
+ // Moves the selection highlight above, below, to the left of, or to the right of the
+ // currently selected.
+ // "Selecting" a DVD button simply highlights the button but does
+ // not "Activate" the button. Selecting is the Windows equivalent
+ // to tabbing to a button but not pressing the space bar or enter key.
+ // Activating is the Windows equivalent of pressing the space bar or
+ // enter key after tabbing to a button.
+ // Annex J: Upper_button_Select, Lower_button_Select, Left_button_Select, Right_button_Select
+ HRESULT SelectRelativeButton( DVD_RELATIVE_BUTTON buttonDir );
+
+ // ActivateButton
+ // Activates current button.
+ // Annex J: Button_Activate
+ HRESULT ActivateButton();
+
+ // SelectButton
+ // Selects a specific button (with the index from 1 to 36).
+ // ulButton is intended to be a number entered by a user corresponding
+ // to button numbers currently displayed on screen.
+ // Button numbers range from 1 to 36.
+ HRESULT SelectButton
+ ( [in] ULONG ulButton
+ );
+
+ // SelectAndActivateButton
+ // Selects and then activates the button specified by the user.
+ // ulButton is intended to be a number entered by a user corresponding
+ // to button numbers currently displayed on screen.
+ // Annex J: Button_Select_And_Activate
+ // Button numbers range from 1 to 36.
+ HRESULT SelectAndActivateButton
+ ( [in] ULONG ulButton
+ );
+
+ // StillOff
+ // Releases any current still if there are no available buttons.
+ // This includes VOBU stills, Cell stills, and PGC stills, whether the
+ // still is infinite. When buttons are available, stills are released by
+ // activating a button. Note this does not release a Pause.
+ // Annex J: Still_Off
+ HRESULT StillOff();
+
+ // Pause
+ // Freezes / unfreezes playback and any internal timers. This is similar to
+ // IMediaControl::Pause(), but not the same in effect as IMediaControl::Pause
+ // puts the filter (all filters, if done to the graph) in paused state.
+ // Annex J: Pause_On and Pause_Off
+ // bState is TRUE or FALSE to indicate whether to do Puase_on/Pause_Off according
+ // to Annex J terminology.
+ HRESULT Pause
+ ( [in] BOOL bState
+ );
+
+ // SelectAudioStream
+ // Changes the current audio stream to ulAudio.
+ // Annex J: Audio_Stream_Change
+ // Audio stream number ranges between 0 and 7 or DEFAULT_AUDIO_STREAM (15 - default based on default language & language extension)
+ HRESULT SelectAudioStream
+ ( [in] ULONG ulAudio,
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+
+ );
+
+ // SelectSubpictureStream
+ // Changes the current subpicture stream number to ulSubPicture
+ // Annex J: Sub-picture_Stream_Change (first param)
+ // Subpicture stream number should be between 0 and 31 or 63.
+ HRESULT SelectSubpictureStream
+ ( [in] ULONG ulSubPicture,
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+
+ );
+
+ // SetSubpictureState
+ // Turns on/off current subpicture stream display.
+ // Annex J: Sub-picture_Stream_Change (second param)
+ // Subpicture state is On or Off (TRUE or FALSE)
+ HRESULT SetSubpictureState
+ ( [in] BOOL bState,
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+ );
+
+ // SelectAngle
+ // Changes the current angle number.
+ // Annex J: Angle_Change
+ // Angle number is between 1 and 9.
+ HRESULT SelectAngle
+ ( [in] ULONG ulAngle,
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+ );
+
+ // SelectParentalLevel
+ // Selects the current player parental level.
+ // Annex J: Parental_Level_Select
+ // Parental level ranges between 1 and 8.
+ // The defined parental levels are listed below :
+ //
+ // Level Rating
+ // ----- ------
+ // 1 G
+ // 3 PG
+ // 4 PG13
+ // 6 R
+ // 7 NC17
+ // Higher levels can play lower level content; lower levels cannot play
+ // higher level content. The DVD Navigator provides no restriction on
+ // setting the parental level. DVD player application may enforce
+ // restriction on parental level setting, such as password protection for
+ // raising the current parental level. Parental Management is disabled in
+ // the Navigator by default.
+ //
+ // Note : To disable parental management, pass 0xffffffff for ulParentalLevel
+ // If parental management is disabled, then the player will play the
+ // first PGC in a parental block regardless of parental IDs.
+ //
+ HRESULT SelectParentalLevel
+ ( [in] ULONG ulParentalLevel
+ );
+
+ // SelectParentalCountry
+ // Sets the country in which to interpret the Parental Level.
+ // Annex J: Parental_Country_Select
+ // The country specified using the Alpha-2 code of the ISO-3166 standard,
+ HRESULT SelectParentalCountry
+ ( [in] BYTE bCountry[2]
+ );
+
+ // SelectKaraokeAudioPresentationMode
+ // Sets the Karaoke audio mode.
+ // Annex J: Karaoke_Audio_Presentation_Mode_Change
+ // NOTE: This and all other Karoke support is currently not implemented.
+ // Mode represents the audio mixing mode for Karaoke (same info as SPRM11).
+ // Use a bitwise OR of the bits in DVD_KARAOKE_DOWNMIX
+ HRESULT SelectKaraokeAudioPresentationMode
+ ( [in] ULONG ulMode
+ );
+
+ // SelectVideoModePreference
+ // The user can specify the (initial) preferred display mode (aspect ratio)
+ // (wide / letterbox / pan-scan) that should be used to display content
+ // (16 : 9).
+ // Annex J: Video_Presentation_Mode_Change
+ // The parameter is a ULONG that has one of the values defined in
+ // DVD_PREFERRED_DISPLAY_MODE
+ HRESULT SelectVideoModePreference
+ ( [in] ULONG ulPreferredDisplayMode
+ );
+
+ // SetDVDDirectory
+ // Sets the root directory containing the DVD-Video volume.
+ // Can only be called from the DVD Stop State (DVD_DOMAIN_Stop).
+ // If the root directory is not successfully set before
+ // IMediaControl::Play is called, the first drive starting from c:
+ // containing a VIDEO_TS directory in the top level directory
+ // will be used as the root.
+ HRESULT SetDVDDirectory
+ ( [in] LPCWSTR pszwPath
+ );
+
+ // ActivateAtPosition
+ // This is typically called in response to a mouse click.
+ // The specified point within the display window is to see if it is
+ // within a current DVD button's highlight rect. If it is, that
+ // button is first selected, then activated.
+ // NOTE: DVD Buttons do not all necessarily have highlight rects,
+ // button rects can overlap, and button rects do not always
+ // correspond to the visual representation of DVD buttons.
+ HRESULT ActivateAtPosition // typically called after a mouse click
+ ( [in] POINT point
+ );
+
+ // SelectAtPosition
+ // This is typically called in response to a mouse move within the
+ // display window.
+ // The specified point within the display window is to see if it is
+ // within a current DVD button's highlight rect. If it is, that
+ // button is selected.
+ // NOTE: DVD Buttons do not all necessarily have highlight rects,
+ // button rects can overlap, and button rects do not always
+ // correspond to the visual representation of DVD buttons.
+ HRESULT SelectAtPosition // typically called after a mouse move
+ ( [in] POINT point
+ );
+
+ // PlayChaptersAutoStop
+ // Start playing at the specified chapter within the specified title
+ // and play the number of chapters specified by the third parameter.
+ // Then the playback stops by sending an event EC_DVD_CHAPTER_AUTOSTOP.
+ // Title ranges from 1 to 99.
+ // Chapter (and number of chapters to play) ranges from 1 to 999.
+ HRESULT PlayChaptersAutoStop
+ ( [in] ULONG ulTitle, // title number
+ [in] ULONG ulChapter, // chapter number to start playback
+ [in] ULONG ulChaptersToPlay, // number of chapters to play from the start chapter
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+ );
+
+ // AcceptParentalLevelChange
+ //
+ // Application's way of informing the Navigator that the required parental
+ // level change indicated through a previous event was accepted or rejected
+ // by the app (and unblock the Navigator).
+ //
+ // FALSE - reject the disc's request to change the current parental level.
+ // TRUE - change the parental level as required by the disc.
+ HRESULT AcceptParentalLevelChange
+ ( [in] BOOL bAccept
+ );
+
+ // SetOption(flag, true/false )
+ // Flags:
+ //
+ // DVD_ResetOnStop
+ // Disable reset of the Navigator's internal state on the
+ // subsequent IMediaControl::Stop() call(s).
+ //
+ // FALSE - Navigator does not reset its state on the subsequent Stop calls
+ // (play from the current location on next Run call).
+ // TRUE - (default) Navigator resets its state on the subsequent Stop call
+ // (play from the first play PGC on the Run call after the Stop).
+ //
+ // DVD_NotifyParentalLevelChange
+ //
+ // Allows the application to indicate to the Navigator that it wants to control
+ // parent level change (e.g., through a dialog box) and indicate the acceptance
+ // or rejection of the new parental level to the Navigator through
+ // AcceptParentalLevelChange().
+ //
+ // FALSE - disable (default). Always reject request by the disc to change parental level.
+ // TRUE - enable. Navigator will send the app a 'EC_DVD_PARENTAL_LEVEL_CHANGE' event
+ // and block until AcceptParentalLevelChange() is called by the app.
+ //
+ // DVD_HMSF_TimeCodeEvents
+ //
+ // Lets the application specify to the Navigator if it wants to get the new time
+ // event EC_DVD_CURRENT_HMSF_TIME with the HMSF format rather than the older
+ // EC_DVD_CURRENT_TIME events.
+ //
+ // FALSE - disable (default). Older EC_DVD_CURRENT_TIME events are returned.
+ // TRUE - enable. Navigator will send the app EC_DVD_CURRENT_HMSF_TIME events.
+
+ HRESULT SetOption
+ ( [in] DVD_OPTION_FLAG flag,
+ [in] BOOL fState
+ );
+
+ // SetState
+ //
+ // The navigator will use the location information in the given state object to restore
+ // the navigator's position to a specific location on the disc.
+ // A valid state object is returned by either calling GetState(), or by using
+ // "CoCreateInstance( CLSID_DVDState, NULL, CLSCTX_INPROC_SERVER, IID_IDvdState, (void **) ppState )"
+ // to create a state object, followed by pState->IPersist::Load() to read it from memory or disk.
+ //
+ HRESULT SetState
+ ( [in] IDvdState* pState,
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+
+ );
+
+ // PlayPeriodInTitleAutoStop
+ //
+ // Start playing from the specified time within the specified title number until the specified end time.
+ // NOTE: the actual start and end times will be the closest sync points before
+ // or equal to the specified frame number.
+ // Annex J: Time_Play for a limited range
+ // Title numbers range between 1 and 99.
+ HRESULT PlayPeriodInTitleAutoStop
+ ( [in] ULONG ulTitle,
+ [in] DVD_HMSF_TIMECODE* pStartTime,
+ [in] DVD_HMSF_TIMECODE* pEndTime,
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+ );
+
+ // SetGPRM
+ // Sets the current contents of a DVD General Parameter Register.
+ // Use of GPRMs is title specific.
+
+ HRESULT SetGPRM
+ ( [in] ULONG ulIndex,
+ [in] WORD wValue,
+ [in] DWORD dwFlags,
+ [out] IDvdCmd** ppCmd
+ );
+
+ // SelectDefaultMenuLanguage
+ // Selects the default language for menus.
+ // Languages are specified with Windows standard LCIDs. LCIDs can be created
+ // from ISO-639 codes with
+ // MAKELCID( MAKELANGID(wISO639LangID ,SUBLANG_DEFAULT ), SORT_DEFAULT ).
+ // SelectMenuLanguage may only called from the DVD Stop state (DVD_DOMAIN_Stop).
+ // Annex J: Menu_Language_Select
+ //
+ // NOT TRUE ANYMORE:
+ // NOTE: MAKELANGID seems to have a bug so 'jp' may have to be used
+ // instead of 'ja' for the ISO639 code for Japanese.
+ HRESULT SelectDefaultMenuLanguage
+ ( [in] LCID Language
+ );
+
+ // SelectDefaultAudioLanguage
+ // Selects the default audio language.
+ // Languages are specified with Windows standard LCIDs.
+ HRESULT SelectDefaultAudioLanguage
+ ( [in] LCID Language,
+ [in] DVD_AUDIO_LANG_EXT audioExtension
+ );
+
+ // SelectDefaultSubpictureLanguage
+ // Selects the default subpicture language.
+ // Languages are specified with Windows standard LCIDs.
+ HRESULT SelectDefaultSubpictureLanguage
+ ( [in] LCID Language,
+ [in] DVD_SUBPICTURE_LANG_EXT subpictureExtension
+ );
+}
+
+
+//==========================================================================
+//==========================================================================
+// IDvdInfo2 interface -- allows an app to query for attributes of available
+// DVD titles and DVD player status. Also allows for control of a DVD
+// player beyond Annex J in the DVD spec.
+//==========================================================================
+//==========================================================================
+
+enum DVD_TextStringType {
+ // disc structure (0x00..0x0f)
+ DVD_Struct_Volume = 0x01,
+ DVD_Struct_Title = 0x02,
+ DVD_Struct_ParentalID = 0x03,
+ DVD_Struct_PartOfTitle = 0x04,
+ DVD_Struct_Cell = 0x05,
+ // stream (0x10..0x1f)
+ DVD_Stream_Audio = 0x10,
+ DVD_Stream_Subpicture = 0x11,
+ DVD_Stream_Angle = 0x12,
+ // channel in stream (0x20..0x2f)
+ DVD_Channel_Audio = 0x20,
+
+ // Application information
+ // General (0x30..0x37)
+ DVD_General_Name = 0x30,
+ DVD_General_Comments = 0x31,
+
+ // Title (0x38..0x3f)
+ DVD_Title_Series = 0x38,
+ DVD_Title_Movie = 0x39,
+ DVD_Title_Video = 0x3a,
+ DVD_Title_Album = 0x3b,
+ DVD_Title_Song = 0x3c,
+ DVD_Title_Other = 0x3f,
+
+ // Title (sub) (0x40..0x47)
+ DVD_Title_Sub_Series = 0x40,
+ DVD_Title_Sub_Movie = 0x41,
+ DVD_Title_Sub_Video = 0x42,
+ DVD_Title_Sub_Album = 0x43,
+ DVD_Title_Sub_Song = 0x44,
+ DVD_Title_Sub_Other = 0x47,
+
+ // Title (original) (0x48..0x4f)
+ DVD_Title_Orig_Series = 0x48,
+ DVD_Title_Orig_Movie = 0x49,
+ DVD_Title_Orig_Video = 0x4a,
+ DVD_Title_Orig_Album = 0x4b,
+ DVD_Title_Orig_Song = 0x4c,
+ DVD_Title_Orig_Other = 0x4f,
+
+ // Other info (0x50..0x57)
+ DVD_Other_Scene = 0x50,
+ DVD_Other_Cut = 0x51,
+ DVD_Other_Take = 0x52,
+
+ // Language 0x58..0x5b
+ // Work 0x5c..0x6b
+ // Character 0x6c..0x8f
+ // Data 0x90..0x93
+ // Karaoke 0x94..0x9b
+ // Category 0x9c..0x9f
+ // Lyrics 0xa0..0xa3
+ // Document 0xa4..0xa7
+ // Others 0xa8..0xab
+ // Reserved 0xac..0xaf
+ // Admin 0xb0..0xb7
+ // more admin 0xb8..0xc0
+ // Reserved 0xd0..0xdf
+ // vendor 0xe0..0xef
+ // extension 0xf0..0xf7
+ // reserved 0xf8..0xff
+};
+
+enum DVD_TextCharSet {
+ DVD_CharSet_Unicode = 0,
+ DVD_CharSet_ISO646 = 1,
+ DVD_CharSet_JIS_Roman_Kanji = 2,
+ DVD_CharSet_ISO8859_1 = 3,
+ DVD_CharSet_ShiftJIS_Kanji_Roman_Katakana = 4
+};
+
+cpp_quote ("#define DVD_TITLE_MENU 0x000")
+cpp_quote ("#define DVD_STREAM_DATA_CURRENT 0x800")
+cpp_quote ("#define DVD_STREAM_DATA_VMGM 0x400")
+cpp_quote ("#define DVD_STREAM_DATA_VTSM 0x401")
+cpp_quote ("#define DVD_DEFAULT_AUDIO_STREAM 0x0f")
+
+// DVD Decoder Caps data
+typedef struct tagDVD_DECODER_CAPS
+{
+ DWORD dwSize ; // size of this struct
+ DWORD dwAudioCaps ; // bits indicating audio support (AC3, DTS, SDDS, LPCM etc.) of decoder
+ double dFwdMaxRateVideo ; // max data rate for video going forward
+ double dFwdMaxRateAudio ; // ... .. .. ... audio ... ...
+ double dFwdMaxRateSP ; // ... .. .. ... SP ... ...
+ double dBwdMaxRateVideo ; // if smooth reverse is not available, this will be set to 0
+ double dBwdMaxRateAudio ; // -- ditto --
+ double dBwdMaxRateSP ; // -- ditto --
+ DWORD dwRes1 ; // reserved for future expansion
+ DWORD dwRes2 ; // -- ditto --
+ DWORD dwRes3 ; // -- ditto --
+ DWORD dwRes4 ; // -- ditto --
+} DVD_DECODER_CAPS ;
+
+// Bits for decoder's audio format support
+cpp_quote ("#define DVD_AUDIO_CAPS_AC3 0x00000001")
+cpp_quote ("#define DVD_AUDIO_CAPS_MPEG2 0x00000002")
+cpp_quote ("#define DVD_AUDIO_CAPS_LPCM 0x00000004")
+cpp_quote ("#define DVD_AUDIO_CAPS_DTS 0x00000008")
+cpp_quote ("#define DVD_AUDIO_CAPS_SDDS 0x00000010")
+
+
+[
+object,
+uuid(34151510-EEC0-11D2-8201-00A0C9D74842),
+pointer_default(unique)
+]
+
+interface IDvdInfo2 : IUnknown {
+ import "unknwn.idl";
+
+ // GetCurrentDomain
+ // Returns the current DVD Domain of the DVD player.
+ HRESULT GetCurrentDomain
+ ( [out] DVD_DOMAIN *pDomain
+ );
+
+ // GetCurrentLocation
+ // Returns information sufficient to restart playback of a video
+ // from the current playback location in titles that don't explicitly
+ // disable seeking to the current location.
+ HRESULT GetCurrentLocation
+ ( [out] DVD_PLAYBACK_LOCATION2 *pLocation
+ );
+
+ // GetTotalTitleTime
+ // Returns the total playback time for the current title. Only works
+ // for One_Sequential_PGC_Titles.
+ // THIS SHOULD CHANGE, RIGHT?
+ HRESULT GetTotalTitleTime
+ ( [out] DVD_HMSF_TIMECODE* pTotalTime,
+ [out] ULONG* ulTimeCodeFlags // union of DVD_TIMECODE_FLAGS
+ );
+
+ // GetCurrentButton
+ // Indicates the number of currently available buttons and the current
+ // selected button number. If buttons are not present it returns 0 for
+ // both pulButtonsAvailable and pulCurrentButton
+ HRESULT GetCurrentButton
+ ( [out] ULONG * pulButtonsAvailable,
+ [out] ULONG * pulCurrentButton
+ );
+
+ // GetCurrentAngle
+ // Indicates the number of currently available angles and the current
+ // selected angle number. If *pulAnglesAvailable is returned as 1 then
+ // the current content is not multiangle.
+ HRESULT GetCurrentAngle
+ ( [out] ULONG * pulAnglesAvailable,
+ [out] ULONG * pulCurrentAngle
+ );
+
+ // GetCurrentAudio
+ // Indicates the number of currently available audio streams and
+ // the currently selected audio stream number.
+ // This only works inside the Title domain.
+ HRESULT GetCurrentAudio
+ ( [out] ULONG * pulStreamsAvailable,
+ [out] ULONG * pulCurrentStream
+ );
+
+ // GetCurrentSubpicture
+ // Indicates the number of currently available subpicture streams,
+ // the currently selected subpicture stream number, and if the
+ // subpicture display is currently disabled. Subpicture streams
+ // authored as "Forcedly Activated" stream will be displayed even if
+ // subpicture display has been disabled by the app with
+ // IDVDControl::SetSubpictureState.
+ // This only works inside the Title domain.
+ HRESULT GetCurrentSubpicture
+ ( [out] ULONG * pulStreamsAvailable,
+ [out] ULONG * pulCurrentStream,
+ [out] BOOL * pbIsDisabled
+ );
+
+ // GetCurrentUOPS
+ // Indicates which IDVDControl methods (Annex J user operations) are
+ // currently valid. DVD titles can enable or disable individual user
+ // operations at almost any point during playback.
+ HRESULT GetCurrentUOPS
+ ( [out] ULONG * pulUOPs
+ );
+
+ // GetAllSPRMs
+ // Returns the current contents of all DVD System Parameter Registers.
+ // See DVD-Video spec for use of individual registers.
+ // WE SHOULD DOC THE SPRMs RATHER THAN ASKING TO REFER TO DVD SPEC.
+ HRESULT GetAllSPRMs
+ ( [out] SPRMARRAY * pRegisterArray
+ );
+
+ // GetAllGPRMs
+ // Returns the current contents of all DVD General Parameter Registers.
+ // Use of GPRMs is title specific.
+ // WE SHOULD DOC THE GPRMs RATHER THAN ASKING TO REFER TO DVD SPEC.
+ HRESULT GetAllGPRMs
+ ( [out] GPRMARRAY * pRegisterArray
+ );
+
+ // GetAudioLanguage
+ // Returns the language of the specified stream within the current title.
+ // Does not return languages for menus. Returns *pLanguage as 0 if the
+ // stream does not include language.
+ // Use Win32 API GetLocaleInfo(*pLanguage, LOCALE_SENGLANGUAGE, pszString, cbSize)
+ // to create a human readable string name from the returned LCID.
+ HRESULT GetAudioLanguage
+ ( [in] ULONG ulStream,
+ [out] LCID * pLanguage
+ );
+
+ // GetSubpictureLanguage
+ // Returns the language of the specified stream within the current title.
+ // Does not return languages for menus. Returns *pLanguage=0 as 0 if the
+ // stream does not include language.
+ // Use Win32 API GetLocaleInfo(*pLanguage, LOCALE_SENGLANGUAGE, pszString, cbSize)
+ // to create a human readable string name from the returned LCID.
+ HRESULT GetSubpictureLanguage
+ ( [in] ULONG ulStream,
+ [out] LCID * pLanguage
+ );
+
+ // GetTitleAttributes
+ // Returns attributes of all video, audio, and subpicture streams for the
+ // specified title including menus.
+ // If 0xffffffff is specified as ulTitle, attributes for the current title
+ // are returned.
+ HRESULT GetTitleAttributes
+ ( [in] ULONG ulTitle, // requested title number
+ [out] DVD_MenuAttributes * pMenu,
+ [out] DVD_TitleAttributes * pTitle
+ );
+
+ // GetVMGAttributes
+ // Returns attributes of all video, audio, and subpicture
+ // streams for Video Manager Menus. This method suppliments GetTitleAttributes()
+ // for some menus, such as the Title menu, which are in a separate group of
+ // streams called the VMG (Video Manager) and are not associated with any
+ // particular title number.
+ HRESULT GetVMGAttributes
+ ( [out] DVD_MenuAttributes* pATR
+ );
+
+ // GetCurrentVideoAttributes
+ // Returns the video attributes for the current title or menu.
+ //
+ HRESULT GetCurrentVideoAttributes
+ ( [out] DVD_VideoAttributes * pATR
+ );
+
+ // GetAudioAttributes
+ // Returns the audio attributes for the specified stream in the current title
+ // or menu.
+ HRESULT GetAudioAttributes
+ ( [in] ULONG ulStream,
+ [out] DVD_AudioAttributes *pATR
+ );
+
+ // GetKaraokeChannelContents
+ // Returns the karaoke contents of each channel of the specified stream in the current title
+ // or menu.
+ HRESULT GetKaraokeAttributes
+ ( [in] ULONG ulStream,
+ [out] DVD_KaraokeAttributes* pAttributes
+ );
+
+ // GetSubpictureAttributes
+ // Returns the subpicture attributes for the specified stream in the current
+ // title or menu.
+ HRESULT GetSubpictureAttributes
+ ( [in] ULONG ulStream,
+ [out] DVD_SubpictureAttributes *pATR
+ );
+
+ // GetDVDVolumeInfo
+ // Returns current DVD volume information.
+ HRESULT GetDVDVolumeInfo
+ ( [out] ULONG *pulNumOfVolumes, // number of volumes (disc sides?) in a volume set
+ [out] ULONG *pulVolume, // volume number for current DVD directory
+ [out] DVD_DISC_SIDE *pSide, // current disc side
+ [out] ULONG *pulNumOfTitles // number of titles available in this volume
+ );
+
+ // GetDVDTextNumberOfLanguages
+ // Returns the number of text languages for the current DVD directory.
+ // Should return some error code if no root directory is found.
+ HRESULT GetDVDTextNumberOfLanguages
+ ( [out] ULONG * pulNumOfLangs
+ );
+
+ // GetDVDTextLanguageInfo
+ // Returns the text languages information (number of strings, language code,
+ // char set) for the specified language index.
+ // Should return some error code if an invalid text index is specified.
+ HRESULT GetDVDTextLanguageInfo
+ ( [in] ULONG ulLangIndex,
+ [out] ULONG* pulNumOfStrings,
+ [out] LCID* pLangCode,
+ [out] enum DVD_TextCharSet * pbCharacterSet
+ );
+
+ // GetDVDTextStringAsNative
+ // Returns the text string as an array of bytes for the specified language
+ // index.and string index.
+ // Should return some error code if an invalid text or string index is specified.
+ // It also just returns the length of the string if pchBuffer is specified as NULL.
+ HRESULT GetDVDTextStringAsNative
+ ( [in] ULONG ulLangIndex,
+ [in] ULONG ulStringIndex,
+ [out] BYTE* pbBuffer,
+ [in] ULONG ulMaxBufferSize,
+ [out] ULONG* pulActualSize,
+ [out] enum DVD_TextStringType* pType
+ );
+
+ // GetDVDTextStringAsUnicode
+ // Returns the text string in Unicode for the specified language index.and string index.
+ // Should return some error code if an invalid text or string index is specified.
+ // It also just returns the length of the string if pchBuffer is specified as NULL.
+ HRESULT GetDVDTextStringAsUnicode
+ ( [in] ULONG ulLangIndex,
+ [in] ULONG ulStringIndex,
+ [out] WCHAR* pchwBuffer,
+ [in] ULONG ulMaxBufferSize,
+ [out] ULONG* pulActualSize,
+ [out] enum DVD_TextStringType* pType
+ );
+
+ // GetPlayerParentalLevel
+ // Returns the current parental level and the current country code that has
+ // been set in the system registers in player.
+ // See Table 3.3.4-1 of the DVD-Video spec for the defined parental levels.
+ // Valid Parental Levels range from 1 to 8 if parental management is enabled.
+ // Returns 0xffffffff if parental management is disabled
+ // See ISO3166 : Alpha-2 Code for the country codes.
+ HRESULT GetPlayerParentalLevel
+ ( [out] ULONG *pulParentalLevel, // current parental level
+ [out] BYTE pbCountryCode[2] // current country code
+ );
+
+ // GetNumberOfChapters
+ // Returns the number of chapters that are defined for a
+ // given title.
+ HRESULT GetNumberOfChapters
+ ( [in] ULONG ulTitle, // Title for which number of chapters is requested
+ [out] ULONG *pulNumOfChapters // Number of chapters for the specified title
+ );
+
+ // GetTitleParentalLevels
+ // Returns the parental levels that are defined for a particular title.
+ // pulParentalLevels will be combination of DVD_PARENTAL_LEVEL_8,
+ // DVD_PARENTAL_LEVEL_6, or DVD_PARENTAL_LEVEL_1 OR-ed together
+ HRESULT GetTitleParentalLevels
+ ( [in] ULONG ulTitle, // Title for which parental levels are requested
+ [out] ULONG *pulParentalLevels // Parental levels defined for the title "OR"ed together
+ );
+
+ // GetDVDDirectory
+ // Returns the root directory that is set in the player. If a valid root
+ // has been found, it returns the root string. Otherwise, it returns 0 for
+ // pcbActualSize indicating that a valid root directory has not been found
+ // or initialized.
+ //
+ // !!! used to return LPTSTR. interface was changed to return
+ // LPSTR (ansi) for compatibility. COM APIs should pass with
+ // UNICODE strings only.
+ //
+ HRESULT GetDVDDirectory
+ ( [out, size_is(ulMaxSize)] LPWSTR pszwPath, // pointer to buffer to get root string
+ [in] ULONG ulMaxSize, // size of buffer in WCHARs passed in
+ [out] ULONG *pulActualSize // size of actual data returned (in WCHARs)
+ );
+
+
+ // IsAudioStreamEnabled
+ //
+ // Determines if the specified audio stream is enabled/disabled in the current PGC.
+ //
+ // ulStreamNum - audio stream number to test
+ // pbEnabled - where to place the result
+ HRESULT IsAudioStreamEnabled
+ ( [in] ULONG ulStreamNum, // stream number to test
+ [out] BOOL *pbEnabled // returned state
+ );
+
+ // GetDiscID
+ //
+ // If pszwPath is specified as NULL, DVD Navigator will use the current path
+ // that would be returned by GetDVDDirectory() at this point.
+ //
+ // Returns a 64-bit identification number for the specified DVD disc.
+ HRESULT GetDiscID
+ ( [in] LPCWSTR pszwPath, // root path (should we rather use const WCHAR*?)
+ [out] ULONGLONG* pullDiscID // 64-bit unique id for the disc
+ ) ;
+
+ // GetState
+ //
+ // The navigator will create a new state object and save the current location into it.
+ // The state object can be used to restore the navigator the saved location at a later time.
+ // A new IDvdState object is created (with a single AddRef) and returned in *pStateData.
+ // The object must be Released() when the application is finished with it.
+ //
+ HRESULT GetState
+ ( [out] IDvdState **pStateData // returned object
+ );
+
+ //
+ // GetMenuLanguages
+ //
+ // Navigator gets all of the menu languages for the VMGM and VTSM domains.
+ //
+ HRESULT GetMenuLanguages
+ ( [out] LCID *pLanguages, // data buffer (NULL returns #languages)
+ [in] ULONG ulMaxLanguages, // maxiumum number of languages to retrieve
+ [out] ULONG *pulActualLanguages // actual number of languages retrieved
+ );
+
+ //
+ // GetButtonAtPosition
+ //
+ // This is typically called in response to a mouse move within the
+ // display window.
+ // It returns the button located at the specified point within the display window.
+ // If no button is present at that position, then VFW_E_DVD_NO_BUTTON is returned.
+ // Button indices start at 1.
+ //
+ // NOTE: DVD Buttons do not all necessarily have highlight rects,
+ // button rects can overlap, and button rects do not always
+ // correspond to the visual representation of DVD buttons.
+ HRESULT GetButtonAtPosition // typically called after a mouse move
+ ( [in] POINT point,
+ [out] ULONG *pulButtonIndex
+ );
+
+ //
+ // GetCmdFromEvent
+ //
+ // This method maps an EC_DVD_CMD_BEGIN/COMPLETE/CANCEL event's lParam1 into an AddRef'd
+ // IDvdCmd pointer. You must Release the returned pointer. NULL is returned if the function
+ // fails.
+ //
+ HRESULT GetCmdFromEvent
+ ( [in] LONG_PTR lParam1,
+ [out] IDvdCmd **pCmdObj
+ );
+
+ // GetDefaultMenuLanguage
+ // Returns the default language for menus.
+ HRESULT GetDefaultMenuLanguage
+ ( [out] LCID * pLanguage
+ );
+
+ // GetDefaultAudioLanguage
+ // Gets the default audio language.
+ // Languages are specified with Windows standard LCIDs.
+ HRESULT GetDefaultAudioLanguage
+ ( [out] LCID* pLanguage,
+ [out] DVD_AUDIO_LANG_EXT* pAudioExtension
+ );
+
+ // GetDefaultSubpictureLanguage
+ // Gets the default subpicture language.
+ // Languages are specified with Windows standard LCIDs.
+ HRESULT GetDefaultSubpictureLanguage
+ ( [out] LCID* pLanguage,
+ [out] DVD_SUBPICTURE_LANG_EXT* pSubpictureExtension
+ );
+
+ //
+ // GetDecoderCaps:
+ // Retrieves the DVD decoder's details about max data rate for video, audio
+ // and subpicture (going backward and forward) as well as support for various
+ // types of audio (AC3, MPEG2, DTS, SDDS, LPCM).
+ //
+ HRESULT GetDecoderCaps
+ ( [out] DVD_DECODER_CAPS *pCaps
+ ) ;
+
+ //
+ // GetButtonRect:
+ // Retrieves the coordinates for a given button number
+ //
+ HRESULT GetButtonRect
+ ( [in] ULONG ulButton,
+ [out] RECT *pRect
+ ) ;
+
+ // IsSubpictureStreamEnabled
+ //
+ // Determines if the specified subpicture stream is enabled/disabled in the current PGC.
+ //
+ // ulStreamNum - Subpicture stream number to test
+ // pbEnabled - where to place the result
+ HRESULT IsSubpictureStreamEnabled
+ ( [in] ULONG ulStreamNum, // stream number to test
+ [out] BOOL *pbEnabled // returned state
+ );
+}
+
+
+
+//==========================================================================
+//==========================================================================
+//
+// typedefs used by IDvdGraphBuilder interface.
+//
+//==========================================================================
+//==========================================================================
+
+typedef enum _AM_DVD_GRAPH_FLAGS {
+ AM_DVD_HWDEC_PREFER = 0x01, // default
+ AM_DVD_HWDEC_ONLY = 0x02,
+ AM_DVD_SWDEC_PREFER = 0x04,
+ AM_DVD_SWDEC_ONLY = 0x08,
+ AM_DVD_NOVPE = 0x100,
+ AM_DVD_VMR9_ONLY = 0x800 // only use VMR9 (otherwise fail) for rendering
+} AM_DVD_GRAPH_FLAGS ;
+
+typedef enum _AM_DVD_STREAM_FLAGS {
+ AM_DVD_STREAM_VIDEO = 0x01,
+ AM_DVD_STREAM_AUDIO = 0x02,
+ AM_DVD_STREAM_SUBPIC = 0x04
+} AM_DVD_STREAM_FLAGS ;
+
+typedef struct {
+ HRESULT hrVPEStatus ; // VPE mixing error code (0 => success)
+ BOOL bDvdVolInvalid ; // Is specified DVD volume invalid?
+ BOOL bDvdVolUnknown ; // Is DVD volume to be played not specified/not found?
+ BOOL bNoLine21In ; // video decoder doesn't produce line21 (CC) data
+ BOOL bNoLine21Out ; // can't show decoded line21 data as CC on video
+ int iNumStreams ; // number of DVD streams to render
+ int iNumStreamsFailed ; // number of streams failed to render
+ DWORD dwFailedStreamsFlag ; // combination of flags to indicate failed streams
+} AM_DVD_RENDERSTATUS ;
+
+
+//
+// IDvdGraphBuilder interface to build a filter graph for DVD-Video playback.
+//
+
+[
+ object,
+ local,
+ uuid(FCC152B6-F372-11d0-8E00-00C04FD7C08B),
+ pointer_default(unique)
+]
+interface IDvdGraphBuilder : IUnknown {
+
+ // Returns the IGraphBuilder interface for the filtergraph used by the
+ // CDvdGraphBuilder object.
+ // Remember to *ppGB->Release() when you're done with it
+ HRESULT GetFiltergraph
+ ( [out] IGraphBuilder **ppGB
+ ) ;
+
+ // Gets specific interface pointers in the DVD-Video playback graph to
+ // make DVD-Video playback development easier.
+ // It helps get the following interfaces to control playback/show CC/
+ // position window/control volume etc:
+ // - IDvdControl, IDvdInfo
+ // - IAMLine21Decoder
+ // - IVideoWindow, IBasicVideo
+ // - IBasicAudio
+ // This method will return
+ // a) E_INVALIDARG if ppvIF is invalid
+ // b) E_NOINTERFACE if riid is an IID we don't know about
+ // c) VFW_E_DVD_GRAPHNOTREADY if the graph has not been built through
+ // RenderDvdVideoVolume() yet.
+ // Remember to *ppvIF->Release() when you're done with it
+ HRESULT GetDvdInterface
+ ( [in] REFIID riid, // IID of the interface required
+ [out] void **ppvIF // returns pointer to the required interface
+ ) ;
+
+ // Builds a filter graph according to user specs for playing back a
+ // DVD-Video volume.
+ // This method returns S_FALSE if
+ // 1. the graph has been either built, but either
+ // a) VPE mixing doesn't work (app didn't use AM_DVD_NOVPE flag)
+ // b) video decoder doesn't produce line21 data
+ // c) line21 data couldn't be rendered (decoding/mixing problem)
+ // d) the call specified an invalid volume path or DVD Nav couldn't
+ // locate any DVD-Video volume to be played.
+ // 2. some streams didn't render (completely), but the others have
+ // been rendered so that the volume can be partially played back.
+ // The status is indicated through the fields of the pStatus (out)
+ // parameter.
+ // About 1(a), the app will have enough info to tell the user that the
+ // video won't be visible unless a TV is connected to the NTSC out
+ // port of the DVD decoder (presumably HW in this case).
+ // For case 1(b) & (c), the app "can" put up a warning/informative message
+ // that closed captioning is not available because of the decoder.
+ // 1(d) helps an app to ask the user to insert a DVD-Video disc if none
+ // is specified/available in the drive when playback is started.
+ // This method builds the graph even if
+ // - an invalid DVD-Video volume is specified
+ // - the caller uses lpwszPathName = NULL to make the DVD Nav to locate
+ // the default volume to be played back, but DVD Nav doesn't find a
+ // default DVD-Video volume to be played back.
+ // An app can later specify the volume using IDvdControl::SetRoot()
+ // method.
+ // #2 will help the app indicate to the user that some of the streams
+ // can't be played.
+ //
+ // The graph is built using filters based on the dwFlags value (to use
+ // HW decoders or SW decoders or a mix of them).
+ // The dwFlags value is one of the values in AM_DVD_GRAPH_FLAGS enum
+ // type. The default value is AM_DVD_HWDEC_PREFER. None of the
+ // AM_DVD_HWDEC_xxx or AM_DVD_SWDEC_xxx flags can be mixed. However
+ // AM_DVD_NOVPE can be OR-ed with any of the AM_DVD_HWDEC_xxx flags.
+ //
+ // The method returns S_OK if the playback graph is built successfully
+ // with all the streams completely rendered and a valid DVD-Video volume
+ // is specified or a default one has been located.
+ //
+ // If the dwFlags specify conflicting options, E_INVALIDARG is returned.
+ // If the graph building fails, the method returns one of the following
+ // error codes:
+ // VFW_E_DVD_RENDERFAIL, VFW_E_DVD_DECNOTENOUGH
+ //
+ HRESULT RenderDvdVideoVolume
+ ( [in] LPCWSTR lpcwszPathName, // Can be NULL too
+ [in] DWORD dwFlags, // 0 is the default (use max HW)
+ [out] AM_DVD_RENDERSTATUS *pStatus // returns indications of ANY failure
+ ) ;
+}
+
+
+//
+// DDraw Exclusive Mode Video standard COM interface for Overlay Mixer
+//
+[
+ object,
+ local,
+ uuid(153ACC21-D83B-11d1-82BF-00A0C9696C8F),
+ pointer_default(unique)
+]
+interface IDDrawExclModeVideo : IUnknown {
+ // set a ddraw object to be used by the overlay mixer. If even one of the pins
+ // of the ovmixer is connected, then it won't start using the new ddraw obect
+ // immediately but just cache it. It will start using it the next time, all its
+ // pins are disconnected.
+ HRESULT SetDDrawObject([in] IDirectDraw *pDDrawObject);
+
+ // gets the ddraw object currently being used by the overlay mixer. If the app has not
+ // set any ddraw object and the ovmixer has not yet allocated one, then *ppDDrawObject
+ // will be set to NULL and *pbUsingExternal will be set TO FALSE. Otherwise *pbUsingExternal
+ // will be set to TRUE if the ovmixer is currently USING an app given ddraw object and FALSE
+ // othewise
+ HRESULT GetDDrawObject([out] IDirectDraw **ppDDrawObject,
+ [out] BOOL *pbUsingExternal);
+
+ // set a primary surface to be used by the overlay mixer. If even one of the pins
+ // of the ovmixer is connected, then it won't start using the new primary surface
+ // immediately but just cache it. It will start using it the next time, all its
+ // pins are disconnected.
+ // Also when the ovmixer does start using an app given primary surface, it will delete
+ // its output pin (and not draw its own colorkey) since the app is expected to do the
+ // window management and drawing colorkey etc on the primary surface
+ // This function makes sure that the surface provided exposes IDirectDrawSurface3, and
+ // is consistent with the ddraw object provided.
+ HRESULT SetDDrawSurface([in] IDirectDrawSurface *pDDrawSurface);
+
+ // gets the ddraw surface currently being used by the overlay mixer. If the app has not
+ // set any ddraw surface and the ovmixer has not yet allocated one, then *ppDDrawSurface
+ // will be set to NULL and *pbUsingExternal will be set to FALSE. Otherwise *pbUsingExternal
+ // will be set to TRUE if the ovmixer is curretnly USING an app given ddraw surface and FALSE
+ // otherwise
+ HRESULT GetDDrawSurface([out] IDirectDrawSurface **ppDDrawSurface,
+ [out] BOOL *pbUsingExternal);
+
+ // set draw paramters on the ovmixer (src and dest rect). Note that if the mode
+ // of the ovmixer is set to LETTER_BOX, then the ovmixer might show the video in
+ // only a subrect of *prcTarget (see IMixerPinConfig for details).
+ HRESULT SetDrawParameters([in] const RECT * prcSource,
+ [in] const RECT * prcTarget);
+
+ // gets the current video size and picture aspect ratio of the primary stream of the overlay mixer
+ // The app should look for the evene EC_VIDEO_SIZE_AR_CHANGED and on its receipt
+ // call this function again
+ HRESULT GetNativeVideoProps([out] DWORD *pdwVideoWidth,
+ [out] DWORD *pdwVideoHeight,
+ [out] DWORD *pdwPictAspectRatioX,
+ [out] DWORD *pdwPictAspectRatioY);
+
+ // Set the callback interface - the callback interface will be defined in a later release
+ // Currently returns E_NOTIMPL
+ HRESULT SetCallbackInterface([in] IDDrawExclModeVideoCallback *pCallback,
+ [in] DWORD dwFlags);
+}
+
+
+//
+// DDraw Exclusive Mode Video callbacks
+//
+
+// enum for flags
+enum _AM_OVERLAY_NOTIFY_FLAGS {
+ AM_OVERLAY_NOTIFY_VISIBLE_CHANGE = 0x00000001,
+ AM_OVERLAY_NOTIFY_SOURCE_CHANGE = 0x00000002,
+ AM_OVERLAY_NOTIFY_DEST_CHANGE = 0x00000004
+};
+[
+ object,
+ local,
+ uuid(913c24a0-20ab-11d2-9038-00a0c9697298),
+ pointer_default(unique)
+]
+interface IDDrawExclModeVideoCallback : IUnknown {
+
+ // Called once before UpdateOverlay is called with bBefore == TRUE
+ // and once after it is called with bBefore == FALSE and otherwise
+ // identical parameters
+ HRESULT OnUpdateOverlay(
+ [in] BOOL bBefore, // After UpdateOverlayCalled?
+ [in] DWORD dwFlags,// _AM_OVERLAY_NOTIFY enum
+ [in] BOOL bOldVisible,
+ [in] const RECT *prcOldSrc,
+ [in] const RECT *prcOldDest,
+ [in] BOOL bNewVisible,
+ [in] const RECT *prcNewSrc,
+ [in] const RECT *prcNewDest);
+
+ // Called when the surface color key is changed
+ HRESULT OnUpdateColorKey(
+ [in] const COLORKEY *pKey,
+ [in] DWORD dwColor);
+
+ // Called when the video size or aspect ratio changes
+ HRESULT OnUpdateSize( [in] DWORD dwWidth, // Movie pixel width
+ [in] DWORD dwHeight, // Movie pixel height
+ [in] DWORD dwARWidth, // Aspect ratio horizontal
+ [in] DWORD dwARHeight); // Aspect ratio vertical
+}