evcode.h
上传用户:dzyhzl
上传日期:2019-04-29
资源大小:56270k
文件大小:14k
源码类别:

模拟服务器

开发平台:

C/C++

  1. //------------------------------------------------------------------------------
  2. // File: EvCode.h
  3. //
  4. // Desc: List of standard Quartz event codes and the expected params.
  5. //
  6. // Copyright (c) 1992 - 2000, Microsoft Corporation.  All rights reserved.
  7. //------------------------------------------------------------------------------
  8. // Event codes are broken into two groups
  9. //   -- system event codes
  10. //   -- extension event codes
  11. // All system event codes are below EC_USER
  12. #define EC_SYSTEMBASE                       0x00
  13. #define EC_USER                             0x8000
  14. // System-defined event codes
  15. // ==========================
  16. //
  17. // There are three types of system-defined event codes:
  18. //
  19. // 1.  Those which are always passed through to the application
  20. //     (To be collected by calls to GetEvent or within WaitForCompletion.)
  21. //     (e.g. EC_ERRORABORT, EC_USERABORT.)
  22. //
  23. // 2.  Those which are pure internal and will never be passed to
  24. //     the application.  (e.g. EC_SHUTDOWN)
  25. //
  26. // 3.  Those which have default handling.  Default handing implies that
  27. //     the event is not passed to the application.  However, default
  28. //     handling may be canceled by calling
  29. //     IMediaEvent::CancelDefaultHandling.  If the default handling is
  30. //     cancelled in this way, then the message will be delivered to the
  31. //     application and the application must action it appropriately.
  32. //     Default handling can be restored by calling RestoreDefaultHandling.
  33. //
  34. // We will refer to these events as application, internal and defaulted
  35. // events respectively.
  36. //
  37. // System-defined events may have interface pointers, BSTR's, etc passed
  38. // as parameters.  It is therefore essential that, for any message
  39. // retrieved using GetEvent, a matching call to FreeEventParams is made
  40. // to ensure that relevant interfaces are released and storage freed.
  41. // Failure to call FreeEventParams will result in memory leaks, if not
  42. // worse.
  43. //
  44. // Filters sending these messages to the filter graph should not AddRef()
  45. // any interfaces that they may pass as parameters.  The filter graph
  46. // manager will AddRef them if required.  E.g. if the event is to be queued
  47. // for the application or queued to a worker thread.
  48. // Each event listed below is immediately followed by a parameter list
  49. // detailing the types of the parameters associated with the message,
  50. // and an indication of whether the message is an application, internal
  51. // or defaulted message.  This is then followed by a short description.
  52. // The use of "void" in the parameter list implies that the parameter is not
  53. // used.  Such parameters should be zero.
  54. // Other defined EC_ regions:
  55. // DVD event codes           0x0100 - 0x0150 (dvdevcod.h)
  56. // audio device event codes  0x0200 - 0x0250 (audevcod.h)
  57. // WindowsMedia SDK-originated events 0x0251 - 0x0300 (see below)
  58. #define EC_COMPLETE                         0x01
  59. // ( HRESULT, void ) : defaulted (special)
  60. // Signals the completed playback of a stream within the graph.  This message
  61. // is sent by renderers when they receive end-of-stream.  The default handling
  62. // of this message results in a _SINGLE_ EC_COMPLETE being sent to the
  63. // application when ALL of the individual renderers have signaled EC_COMPLETE
  64. // to the filter graph.  If the default handing is canceled, the application
  65. // will see all of the individual EC_COMPLETEs.
  66. #define EC_USERABORT                        0x02
  67. // ( void, void ) : application
  68. // In some sense, the user has requested that playback be terminated.
  69. // This message is typically sent by renderers that render into a
  70. // window if the user closes the window into which it was rendering.
  71. // It is up to the application to decide if playback should actually
  72. // be stopped.
  73. #define EC_ERRORABORT                       0x03
  74. // ( HRESULT, void ) : application
  75. // Operation aborted because of error
  76. #define EC_TIME                             0x04
  77. // ( DWORD, DWORD ) : application
  78. // The requested reference time occurred.  (This event is currently not used).
  79. // lParam1 is low dword of ref time, lParam2 is high dword of reftime.
  80. #define EC_REPAINT                          0x05
  81. // ( IPin * (could be NULL), void ) : defaulted
  82. // A repaint is required - lParam1 contains the (IPin *) that needs the data
  83. // to be sent again. Default handling is: if the output pin which the IPin is
  84. // attached  to supports the IMediaEventSink interface then it will be called
  85. // with the EC_REPAINT first.  If that fails then normal repaint processing is
  86. // done by the filter graph.
  87. // Stream error notifications
  88. #define EC_STREAM_ERROR_STOPPED             0x06
  89. #define EC_STREAM_ERROR_STILLPLAYING        0x07
  90. // ( HRESULT, DWORD ) : application
  91. // lParam 1 is major code, lParam2 is minor code, either may be zero.
  92. #define EC_ERROR_STILLPLAYING               0x08
  93. // ( HRESULT, void ) : application
  94. // The filter graph manager may issue Run's to the graph asynchronously.
  95. // If such a Run fails, EC_ERROR_STILLPLAYING is issued to notify the
  96. // application of the failure.  The state of the underlying filters
  97. // at such a time will be indeterminate - they will all have been asked
  98. // to run, but some are almost certainly not.
  99. #define EC_PALETTE_CHANGED                  0x09
  100. // ( void, void ) : application
  101. // notify application that the video palette has changed
  102. #define EC_VIDEO_SIZE_CHANGED               0x0A
  103. // ( DWORD, void ) : application
  104. // Sent by video renderers.
  105. // Notifies the application that the native video size has changed.
  106. // LOWORD of the DWORD is the new width, HIWORD is the new height.
  107. #define EC_QUALITY_CHANGE                   0x0B
  108. // ( void, void ) : application
  109. // Notify application that playback degradation has occurred
  110. #define EC_SHUTTING_DOWN                    0x0C
  111. // ( void, void ) : internal
  112. // This message is sent by the filter graph manager to any plug-in
  113. // distributors which support IMediaEventSink to notify them that
  114. // the filter graph is starting to shutdown.
  115. #define EC_CLOCK_CHANGED                    0x0D
  116. // ( void, void ) : application
  117. // Notify application that the clock has changed.
  118. // (i.e. SetSyncSource has been called on the filter graph and has been
  119. // distributed successfully to the filters in the graph.)
  120. #define EC_PAUSED                           0x0E
  121. // ( HRESULT, void ) : application
  122. // Notify application the previous pause request has completed
  123. #define EC_OPENING_FILE                     0x10
  124. #define EC_BUFFERING_DATA                   0x11
  125. // ( BOOL, void ) : application
  126. // lParam1 == 1   --> starting to open file or buffer data
  127. // lParam1 == 0   --> not opening or buffering any more
  128. // (This event does not appear to be used by ActiveMovie.)
  129. #define EC_FULLSCREEN_LOST                  0x12
  130. // ( void, IBaseFilter * ) : application
  131. // Sent by full screen renderers when switched away from full screen.
  132. // IBaseFilter may be NULL.
  133. #define EC_ACTIVATE                         0x13
  134. // ( BOOL, IBaseFilter * ) : internal
  135. // Sent by video renderers when they lose or gain activation.
  136. // lParam1 is set to 1 if gained or 0 if lost
  137. // lParam2 is the IBaseFilter* for the filter that is sending the message
  138. // Used for sound follows focus and full-screen switching
  139. #define EC_NEED_RESTART                     0x14
  140. // ( void, void ) : defaulted
  141. // Sent by renderers when they regain a resource (e.g. audio renderer).
  142. // Causes a restart by Pause/put_Current/Run (if running).
  143. #define EC_WINDOW_DESTROYED                 0x15
  144. // ( IBaseFilter *, void ) : internal
  145. // Sent by video renderers when the window has been destroyed. Handled
  146. // by the filter graph / distributor telling the resource manager.
  147. // lParam1 is the IBaseFilter* of the filter whose window is being destroyed
  148. #define EC_DISPLAY_CHANGED                  0x16
  149. // ( IPin *, void ) : internal
  150. // Sent by renderers when they detect a display change. the filter graph
  151. // will arrange for the graph to be stopped and the pin send in lParam1
  152. // to be reconnected. by being reconnected it allows a renderer to reset
  153. // and connect with a more appropriate format for the new display mode
  154. // lParam1 contains an (IPin *) that should be reconnected by the graph
  155. #define EC_STARVATION                       0x17
  156. // ( void, void ) : defaulted
  157. // Sent by a filter when it detects starvation. Default handling (only when
  158. // running) is for the graph to be paused until all filters enter the
  159. // paused state and then run. Normally this would be sent by a parser or source
  160. // filter when too little data is arriving.
  161. #define EC_OLE_EVENT     0x18
  162. // ( BSTR, BSTR ) : application
  163. // Sent by a filter to pass a text string to the application.
  164. // Conventionally, the first string is a type, and the second a parameter.
  165. #define EC_NOTIFY_WINDOW                    0x19
  166. // ( HWND, void ) : internal
  167. // Pass the window handle around during pin connection.
  168. #define EC_STREAM_CONTROL_STOPPED     0x1A
  169. // ( IPin * pSender, DWORD dwCookie )
  170. // Notification that an earlier call to IAMStreamControl::StopAt
  171. // has now take effect.  Calls to the method can be marked
  172. // with a cookie which is passed back in the second parameter,
  173. // allowing applications to easily tie together request
  174. // and completion notifications.
  175. //
  176. // NB: IPin will point to the pin that actioned the Stop.  This
  177. // may not be the pin that the StopAt was sent to.
  178. #define EC_STREAM_CONTROL_STARTED     0x1B
  179. // ( IPin * pSender, DWORD dwCookie )
  180. // Notification that an earlier call to IAMStreamControl::StartAt
  181. // has now take effect.  Calls to the method can be marked
  182. // with a cookie which is passed back in the second parameter,
  183. // allowing applications to easily tie together request
  184. // and completion notifications.
  185. //
  186. // NB: IPin will point to the pin that actioned the Start.  This
  187. // may not be the pin that the StartAt was sent to.
  188. #define EC_END_OF_SEGMENT                   0x1C
  189. //
  190. // ( const REFERENCE_TIME *pStreamTimeAtEndOfSegment, DWORD dwSegmentNumber )
  191. //
  192. // pStreamTimeAtEndOfSegment
  193. //     pointer to the accumulated stream clock
  194. //     time since the start of the segment - this is directly computable
  195. //     as the sum of the previous and current segment durations (Stop - Start)
  196. //     and the rate applied to each segment
  197. //     The source add this time to the time within each segment to get
  198. //     a total elapsed time
  199. //
  200. // dwSegmentNumber
  201. //     Segment number - starts at 0
  202. //
  203. // Notifies that a segment end has been reached when the
  204. // AM_SEEKING_Segment flags was set for IMediaSeeking::SetPositions
  205. // Passes in an IMediaSeeking interface to allow the next segment
  206. // to be defined by the application
  207. #define EC_SEGMENT_STARTED                  0x1D
  208. //
  209. // ( const REFERENCE_TIME *pStreamTimeAtStartOfSegment, DWORD dwSegmentNumber)
  210. //
  211. // pStreamTimeAtStartOfSegment
  212. //     pointer to the accumulated stream clock
  213. //     time since the start of the segment - this is directly computable
  214. //     as the sum of the previous segment durations (Stop - Start)
  215. //     and the rate applied to each segment
  216. //
  217. // dwSegmentNumber
  218. //     Segment number - starts at 0
  219. //
  220. // Notifies that a new segment has been started.
  221. // This is sent synchronously by any entity that will issue
  222. // EC_END_OF_SEGMENT when a new segment is started
  223. // (See IMediaSeeking::SetPositions - AM_SEEKING_Segment flag)
  224. // It is used to compute how many EC_END_OF_SEGMENT notifications
  225. // to expect at the end of a segment and as a consitency check
  226. #define EC_LENGTH_CHANGED                  0x1E
  227. // (void, void)
  228. // sent to indicate that the length of the "file" has changed
  229. #define EC_DEVICE_LOST                     0x1f
  230. // (IUnknown, 0)
  231. //
  232. // request window notification when the device is available again
  233. // (through WM_DEVICECHANGED messages registered with
  234. // RegisterDeviceNotification; see IAMDeviceRemoval interface)
  235. #define EC_STEP_COMPLETE                      0x24
  236. // (BOOL bCacelled, void)
  237. // Step request complete
  238. // if bCancelled is TRUE the step was cancelled.  This can happen
  239. // if the application issued some control request or because there
  240. // was a mode change etc etc
  241. #define EC_SKIP_FRAMES                      0x25
  242. // ( nFramesToSkip, void ) : internal
  243. // Get the filter graph to seek accuratley.
  244. #define EC_TIMECODE_AVAILABLE 0x30
  245. // Sent by filter supporting timecode
  246. // Param1 has a pointer to the sending object
  247. // Param2 has the device ID of the sending object
  248. #define EC_EXTDEVICE_MODE_CHANGE 0x31
  249. // Sent by filter supporting IAMExtDevice
  250. // Param1 has the new mode
  251. // Param2 has the device ID of the sending object
  252. #define EC_GRAPH_CHANGED                        0x50
  253. // Sent by filter to notify interesting graph changes
  254. #define EC_CLOCK_UNSET                      0x51
  255. // ( void, void ) : application
  256. // Used to notify the filter graph to unset the current graph clock.
  257. // Has the affect of forcing the filter graph to reestablish the graph clock
  258. // on the next Pause/Run (note that this is only used by ksproxy, when the pin 
  259. // of a clock providing filter is disconnected)
  260. //------------------------------------------
  261. //
  262. // WindowsMedia SDK filter-specific events:
  263. // 
  264. #define EC_WMT_EVENT_BASE                   0x0251
  265. //
  266. #define EC_WMT_INDEX_EVENT                  EC_WMT_EVENT_BASE
  267. // WindowsMedia SDK-originated file indexing status, sent by WMSDK-based filters
  268. //
  269. // lParam1 is one of the enum WMT_STATUS messages listed below, sent by the WindowsMedia SDK 
  270. // lParam2 is specific to the lParam event 
  271. //
  272. //     the following WMT_STATUS messages are sent for this event:
  273. //         WMT_STARTED        - lParam2 is 0
  274. //         WMT_CLOSED         - lParam2 is 0
  275. //         WMT_INDEX_PROGRESS - lParam2 is a DWORD containing the progress percent complete
  276. //
  277. // end WMSDK-originated events
  278. //-----------------------------------------