2327 lines
88 KiB
Plaintext
2327 lines
88 KiB
Plaintext
//------------------------------------------------------------------------------
|
|
// 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
|
|
}
|