home *** CD-ROM | disk | FTP | other *** search
/ Beginning Direct3D Game Programming / Direct3D.iso / directx / dxf / include / dvdevcod.h < prev    next >
C/C++ Source or Header  |  2000-10-01  |  14KB  |  335 lines
  1. //------------------------------------------------------------------------------
  2. // File: DVDevCod.h
  3. //
  4. // Desc: List of standard DVD-Video event codes and the expected params.
  5. //
  6. // Copyright (c) 1992 - 2000, Microsoft Corporation.  All rights reserved.
  7. //------------------------------------------------------------------------------
  8.  
  9.  
  10. #define EC_DVDBASE                          0x0100
  11.  
  12. #ifndef EXCLUDE_DVDEVCODE_ENUMS
  13.  
  14. typedef enum _tagDVD_ERROR {
  15.     DVD_ERROR_Unexpected=1,         // Something unexpected happened, perhaps content
  16.                                     //   is incorrectly authored.  Playback is stopped.
  17.     DVD_ERROR_CopyProtectFail=2,    // Key exchange for DVD copy protection failed. 
  18.                                     //   Playback is stopped.
  19.     DVD_ERROR_InvalidDVD1_0Disc=3,  // DVD-Video disc is incorrectly authored for v1.0 
  20.                                     //   of spec. Playback is stopped.
  21.     DVD_ERROR_InvalidDiscRegion=4,  // The Disc cannot be played because the disc is not
  22.                                     // authored to play in system region.
  23.                                     // The region mismatch may be fixable by 
  24.                                     // changing the system region with dvdrgn.exe
  25.     DVD_ERROR_LowParentalLevel=5,   // Player parental level is lower than the lowest parental
  26.                                     //   level available in the DVD content. Playback is stopped.
  27.     DVD_ERROR_MacrovisionFail=6,    // Macrovision Distribution Failed.
  28.                                     // Playback is stopped.
  29.     DVD_ERROR_IncompatibleSystemAndDecoderRegions=7,
  30.                                     // No discs can be played because the system region
  31.                                     // does not match the decoder region.
  32.     DVD_ERROR_IncompatibleDiscAndDecoderRegions=8
  33.                                     // The disc cannot be played because the disc is
  34.                                     // not authored to be played in the decoder's region
  35. } DVD_ERROR;
  36.  
  37. typedef enum _tagDVD_WARNING {
  38.     DVD_WARNING_InvalidDVD1_0Disc=1,// DVD-Video disc is incorrectly authored. Playback
  39.                                     //   can continue, but unexpected behavior may occur.
  40.     DVD_WARNING_FormatNotSupported=2,// A decoder would not support the current format.  Playback
  41.                                     //   of a stream (audio, video of SP) may not function.
  42.     DVD_WARNING_IllegalNavCommand=3,// The internal DVD navigation command processor attempted to 
  43.                                     //   process an illegal command.
  44.     DVD_WARNING_Open = 4,           // File Open Failed
  45.     DVD_WARNING_Seek = 5,           // File Seek Failed
  46.     DVD_WARNING_Read = 6            // File Read Failed
  47. } DVD_WARNING;
  48.  
  49. #endif
  50.  
  51. // DVD-Video event codes
  52. // ======================
  53. //
  54. // All DVD-Video event are always passed on to the application, and are 
  55. // never processed by the filter graph
  56.  
  57.  
  58. #define EC_DVD_DOMAIN_CHANGE                    (EC_DVDBASE + 0x01)
  59. // Parameters: ( DWORD, void ) 
  60. // lParam1 is enum DVD_DOMAIN, and indicates the player's new domain
  61. //
  62. // Raised from following domains: all
  63. //
  64. // Signaled when ever the DVD player changes domains.
  65.  
  66.  
  67. #define EC_DVD_TITLE_CHANGE                     (EC_DVDBASE + 0x02)
  68. // Parameters: ( DWORD, void ) 
  69. // lParam1 is the new title number.
  70. //
  71. // Raised from following domains: DVD_DOMAIN_Title
  72. //
  73. // Indicates when the current title number changes.  Title numbers
  74. // range 1 to 99.  This indicates the TTN, which is the title number
  75. // with respect to the whole disc, not the VTS_TTN which is the title
  76. // number with respect to just a current VTS.
  77.  
  78.  
  79. #define EC_DVD_CHAPTER_START                   (EC_DVDBASE + 0x03)
  80. // Parameters: ( DWORD, void ) 
  81. // lParam1 is the new chapter number (which is the program number for 
  82. // One_Sequential_PGC_Titles).
  83. //
  84. // Raised from following domains: DVD_DOMAIN_Title
  85. //
  86. // Signales that DVD player started playback of a new program in the Title 
  87. // domain.  This is only signaled for One_Sequential_PGC_Titles.
  88.  
  89.  
  90. #define EC_DVD_AUDIO_STREAM_CHANGE              (EC_DVDBASE + 0x04)
  91. // Parameters: ( DWORD, void ) 
  92. // lParam1 is the new user audio stream number.
  93. //
  94. // Raised from following domains: all
  95. //
  96. // Signaled when ever the current user audio stream number changes for the main 
  97. // title.  This can be changed automatically with a navigation command on disc
  98. // as well as through IDVDAnnexJ.
  99. // Audio stream numbers range from 0 to 7.  Stream 0xffffffff
  100. // indicates that no stream is selected.
  101.  
  102. #define EC_DVD_SUBPICTURE_STREAM_CHANGE         (EC_DVDBASE + 0x05)
  103. // Parameters: ( DWORD, void ) 
  104. // lParam1 is the new user subpicture stream number.
  105. //
  106. // Raised from following domains: all
  107. //
  108. // Signaled when ever the current user subpicture stream number changes for the main 
  109. // title.  This can be changed automatically with a navigation command on disc
  110. // as well as through IDVDAnnexJ.  
  111. // Subpicture stream numbers range from 0 to 31.  Stream 0xffffffff
  112. // indicates that no stream is selected.  
  113.  
  114. #define EC_DVD_ANGLE_CHANGE                     (EC_DVDBASE + 0x06)
  115. // Parameters: ( DWORD, DWORD ) 
  116. // lParam1 is the number of available angles.
  117. // lParam2 is the current user angle number.
  118. //
  119. // Raised from following domains: all
  120. //
  121. // Signaled when ever either 
  122. //   a) the number of available angles changes, or  
  123. //   b) the current user angle number changes.
  124. // Current angle number can be changed automatically with navigation command 
  125. // on disc as well as through IDVDAnnexJ.
  126. // When the number of available angles is 1, the current video is not multiangle.
  127. // Angle numbers range from 1 to 9.
  128.  
  129.  
  130. #define EC_DVD_BUTTON_CHANGE                    (EC_DVDBASE + 0x07)
  131. // Parameters: ( DWORD, DWORD ) 
  132. // lParam1 is the number of available buttons.
  133. // lParam2 is the current selected button number.
  134. //
  135. // Raised from following domains: all
  136. //
  137. // Signaled when ever either 
  138. //   a) the number of available buttons changes, or  
  139. //   b) the current selected button number changes.
  140. // The current selected button can be changed automatically with navigation 
  141. // commands on disc as well as through IDVDAnnexJ.  
  142. // Button numbers range from 1 to 36.  Selected button number 0 implies that
  143. // no button is selected.  Note that these button numbers enumerate all 
  144. // available button numbers, and do not always correspond to button numbers
  145. // used for IDVDAnnexJ::ButtonSelectAndActivate since only a subset of buttons
  146. // may be activated with ButtonSelectAndActivate.
  147.  
  148.  
  149. #define EC_DVD_VALID_UOPS_CHANGE                (EC_DVDBASE + 0x08)
  150. // Parameters: ( DWORD, void ) 
  151. // lParam1 is a VALID_UOP_SOMTHING_OR_OTHER bit-field stuct which indicates
  152. //   which IDVDAnnexJ commands are explicitly disable by the DVD disc.
  153. //
  154. // Raised from following domains: all
  155. //
  156. // Signaled when ever the available set of IDVDAnnexJ methods changes.  This
  157. // only indicates which operations are explicited disabled by the content on 
  158. // the DVD disc, and does not guarentee that it is valid to call methods 
  159. // which are not disabled.  For example, if no buttons are currently present,
  160. // IDVDAnnexJ::ButtonActivate() won't work, even though the buttons are not
  161. // explicitly disabled. 
  162.  
  163.  
  164. #define EC_DVD_STILL_ON                         (EC_DVDBASE + 0x09)
  165. // Parameters: ( BOOL, DWORD ) 
  166. // lParam1 == 0  -->  buttons are available, so StillOff won't work
  167. // lParam1 == 1  -->  no buttons available, so StillOff will work
  168. // lParam2 indicates the number of seconds the still will last, with 0xffffffff 
  169. //   indicating an infinite still (wait till button or StillOff selected).
  170. //
  171. // Raised from following domains: all
  172. //
  173. // Signaled at the beginning of any still: PGC still, Cell Still, or VOBU Still.
  174. // Note that all combinations of buttons and still are possible (buttons on with
  175. // still on, buttons on with still off, button off with still on, button off
  176. // with still off).
  177.  
  178. #define EC_DVD_STILL_OFF                         (EC_DVDBASE + 0x0a)
  179. // Parameters: ( void, void ) 
  180. //
  181. //   Indicating that any still that is currently active
  182. //   has been released.
  183. //
  184. // Raised from following domains: all
  185. //
  186. // Signaled at the end of any still: PGC still, Cell Still, or VOBU Still.
  187. //
  188.  
  189. #define EC_DVD_CURRENT_TIME                     (EC_DVDBASE + 0x0b)
  190. // Parameters: ( DWORD, BOOL ) 
  191. // lParam1 is a DVD_TIMECODE which indicates the current 
  192. //   playback time code in a BCD HH:MM:SS:FF format.
  193. // lParam2 == 0  -->  time code is 25 frames/sec
  194. // lParam2 == 1  -->  time code is 30 frames/sec (non-drop).
  195. // lParam2 == 2  -->  time code is invalid (current playback time 
  196. //                    cannot be determined for current title)
  197. //
  198. // Raised from following domains: DVD_DOMAIN_Title
  199. //
  200. // Signaled at the beginning of every VOBU, which occurs every .4 to 1.0 sec.
  201. // This is only signaled for One_Sequential_PGC_Titles.
  202.  
  203.  
  204. #define EC_DVD_ERROR                            (EC_DVDBASE + 0x0c)
  205. // Parameters: ( DWORD, void) 
  206. // lParam1 is an enum DVD_ERROR which notifies the app of some error condition.
  207. //
  208. // Raised from following domains: all
  209. //
  210.  
  211. #define EC_DVD_WARNING                           (EC_DVDBASE + 0x0d)
  212. // Parameters: ( DWORD, void) 
  213. // lParam1 is an enum DVD_WARNING which notifies the app of some warning condition.
  214. //
  215. // Raised from following domains: all
  216. //
  217.  
  218. #define EC_DVD_CHAPTER_AUTOSTOP                  (EC_DVDBASE + 0x0e)
  219. // Parameters: (BOOL, void)
  220. // lParam1 is a BOOL which indicates the reason for the cancellation of ChapterPlayAutoStop
  221. // lParam1 == 0 indicates successful completion of ChapterPlayAutoStop
  222. // lParam1 == 1 indicates that ChapterPlayAutoStop is being cancelled as a result of another
  223. //            IDVDControl call or the end of content has been reached & no more chapters
  224. //            can be played.
  225. //  Indicating that playback is stopped as a result of a call
  226. //  to IDVDControl::ChapterPlayAutoStop()
  227. //
  228. // Raised from following domains : DVD_DOMAIN_TITLE
  229. //
  230.  
  231. #define EC_DVD_NO_FP_PGC                         (EC_DVDBASE + 0x0f)
  232. //  Parameters : (void, void)
  233. //
  234. //  Raised from the following domains : FP_DOM
  235. //
  236. //  Indicates that the DVD disc does not have a FP_PGC (First Play Program Chain)
  237. //  and the DVD Navigator will not automatically load any PGC and start playback.
  238. //
  239.  
  240. #define EC_DVD_PLAYBACK_RATE_CHANGE              (EC_DVDBASE + 0x10)
  241. //  Parameters : (LONG, void)
  242. //  lParam1 is a LONG indicating the new playback rate.
  243. //  lParam1 < 0 indicates reverse playback mode.
  244. //  lParam1 > 0 indicates forward playback mode
  245. //  Value of lParam1 is the actual playback rate multiplied by 10000.
  246. //  i.e. lParam1 = rate * 10000
  247. //
  248. //  Raised from the following domains : TT_DOM
  249. //
  250. //  Indicates that a rate change in playback has been initiated and the parameter
  251. //  lParam1 indicates the new playback rate that is being used.
  252. //
  253.  
  254. #define EC_DVD_PARENTAL_LEVEL_CHANGE            (EC_DVDBASE + 0x11)
  255. //  Parameters : (LONG, void)
  256. //  lParam1 is a LONG indicating the new parental level.
  257. //
  258. //  Raised from the following domains : VMGM_DOM
  259. //
  260. //  Indicates that an authored Nav command has changed the parental level
  261. //  setting in the player.
  262. //
  263.  
  264. #define EC_DVD_PLAYBACK_STOPPED                 (EC_DVDBASE + 0x12)
  265. //  Parameters : (void, void)
  266. //
  267. //  Raised from the following domains : All Domains
  268. //
  269. // Indicates that playback has been stopped as the Navigator has completed
  270. // playback of the pgc and did not find any other branching instruction for
  271. // subsequent playback.
  272. //
  273.  
  274. #define EC_DVD_ANGLES_AVAILABLE                 (EC_DVDBASE + 0x13)
  275. //  Parameters : (BOOL, void)
  276. //  lParam1 == 0 indicates that playback is not in an angle block and angles are
  277. //             not available
  278. //  lParam1 == 1 indicates that an angle block is being played back and angle changes
  279. //             can be performed.
  280. //
  281. //  Indicates whether an angle block is being played and if angle changes can be 
  282. //  performed. However, angle changes are not restricted to angle blocks and the
  283. //  manifestation of the angle change can be seen only in an angle block.
  284.  
  285. #define EC_DVD_PLAYPERIOD_AUTOSTOP              (EC_DVDBASE + 0x14)
  286. // Parameters: (void, void)
  287. // Sent when the PlayPeriodInTitle completes or is cancelled
  288. //
  289. // Raised from following domains : DVD_DOMAIN_TITLE
  290. //
  291.  
  292. #define EC_DVD_BUTTON_AUTO_ACTIVATED                 (EC_DVDBASE + 0x15)
  293. // Parameters: (DWORD button, void)
  294. // Sent when a button is automatically activated
  295. //
  296. // Raised from following domains : DVD_DOMAIN_MENU
  297. //
  298.  
  299. #define EC_DVD_CMD_START                 (EC_DVDBASE + 0x16)
  300. // Parameters: (CmdID, HRESULT)
  301. // Sent when a command begins
  302. //
  303.  
  304. #define EC_DVD_CMD_END                 (EC_DVDBASE + 0x17)
  305. // Parameters: (CmdID, HRESULT)
  306. // Sent when a command completes
  307. //
  308.  
  309. #define EC_DVD_DISC_EJECTED                (EC_DVDBASE + 0x18)
  310. // Parameters: none
  311. // Sent when the nav detects that a disc was ejected and stops the playback
  312. // The app does not need to take any action to stop the playback.
  313. //
  314.  
  315. #define EC_DVD_DISC_INSERTED                (EC_DVDBASE + 0x19)
  316. // Parameters: none
  317. // Sent when the nav detects that a disc was inserted and the nav begins playback
  318. // The app does not need to take any action to start the playback.
  319. //
  320.  
  321. #define EC_DVD_CURRENT_HMSF_TIME                     (EC_DVDBASE + 0x1a)
  322. // Parameters: ( ULONG, ULONG ) 
  323. // lParam2 contains a union of the DVD_TIMECODE_FLAGS
  324. // lParam1 contains a DVD_HMSF_TIMECODE.  Assign lParam1 to a ULONG then cast the
  325. // ULONG as a DVD_HMSF_TIMECODE to use its values.
  326. //
  327. // Raised from following domains: DVD_DOMAIN_Title
  328. //
  329. // Signaled at the beginning of every VOBU, which occurs every .4 to 1.0 sec.
  330.  
  331. #define EC_DVD_KARAOKE_MODE                     (EC_DVDBASE + 0x1b)
  332. // Parameters: ( BOOL, reserved ) 
  333. // lParam1 is either TRUE (a karaoke track is being played) or FALSE (no karaoke data is being played).
  334. //
  335.