evcode.h
上传用户:dzyhzl
上传日期:2019-04-29
资源大小:56270k
文件大小:14k
- //------------------------------------------------------------------------------
- // File: EvCode.h
- //
- // Desc: List of standard Quartz event codes and the expected params.
- //
- // Copyright (c) 1992 - 2000, Microsoft Corporation. All rights reserved.
- //------------------------------------------------------------------------------
- // Event codes are broken into two groups
- // -- system event codes
- // -- extension event codes
- // All system event codes are below EC_USER
- #define EC_SYSTEMBASE 0x00
- #define EC_USER 0x8000
- // System-defined event codes
- // ==========================
- //
- // There are three types of system-defined event codes:
- //
- // 1. Those which are always passed through to the application
- // (To be collected by calls to GetEvent or within WaitForCompletion.)
- // (e.g. EC_ERRORABORT, EC_USERABORT.)
- //
- // 2. Those which are pure internal and will never be passed to
- // the application. (e.g. EC_SHUTDOWN)
- //
- // 3. Those which have default handling. Default handing implies that
- // the event is not passed to the application. However, default
- // handling may be canceled by calling
- // IMediaEvent::CancelDefaultHandling. If the default handling is
- // cancelled in this way, then the message will be delivered to the
- // application and the application must action it appropriately.
- // Default handling can be restored by calling RestoreDefaultHandling.
- //
- // We will refer to these events as application, internal and defaulted
- // events respectively.
- //
- // System-defined events may have interface pointers, BSTR's, etc passed
- // as parameters. It is therefore essential that, for any message
- // retrieved using GetEvent, a matching call to FreeEventParams is made
- // to ensure that relevant interfaces are released and storage freed.
- // Failure to call FreeEventParams will result in memory leaks, if not
- // worse.
- //
- // Filters sending these messages to the filter graph should not AddRef()
- // any interfaces that they may pass as parameters. The filter graph
- // manager will AddRef them if required. E.g. if the event is to be queued
- // for the application or queued to a worker thread.
- // Each event listed below is immediately followed by a parameter list
- // detailing the types of the parameters associated with the message,
- // and an indication of whether the message is an application, internal
- // or defaulted message. This is then followed by a short description.
- // The use of "void" in the parameter list implies that the parameter is not
- // used. Such parameters should be zero.
- // Other defined EC_ regions:
- // DVD event codes 0x0100 - 0x0150 (dvdevcod.h)
- // audio device event codes 0x0200 - 0x0250 (audevcod.h)
- // WindowsMedia SDK-originated events 0x0251 - 0x0300 (see below)
- #define EC_COMPLETE 0x01
- // ( HRESULT, void ) : defaulted (special)
- // Signals the completed playback of a stream within the graph. This message
- // is sent by renderers when they receive end-of-stream. The default handling
- // of this message results in a _SINGLE_ EC_COMPLETE being sent to the
- // application when ALL of the individual renderers have signaled EC_COMPLETE
- // to the filter graph. If the default handing is canceled, the application
- // will see all of the individual EC_COMPLETEs.
- #define EC_USERABORT 0x02
- // ( void, void ) : application
- // In some sense, the user has requested that playback be terminated.
- // This message is typically sent by renderers that render into a
- // window if the user closes the window into which it was rendering.
- // It is up to the application to decide if playback should actually
- // be stopped.
- #define EC_ERRORABORT 0x03
- // ( HRESULT, void ) : application
- // Operation aborted because of error
- #define EC_TIME 0x04
- // ( DWORD, DWORD ) : application
- // The requested reference time occurred. (This event is currently not used).
- // lParam1 is low dword of ref time, lParam2 is high dword of reftime.
- #define EC_REPAINT 0x05
- // ( IPin * (could be NULL), void ) : defaulted
- // A repaint is required - lParam1 contains the (IPin *) that needs the data
- // to be sent again. Default handling is: if the output pin which the IPin is
- // attached to supports the IMediaEventSink interface then it will be called
- // with the EC_REPAINT first. If that fails then normal repaint processing is
- // done by the filter graph.
- // Stream error notifications
- #define EC_STREAM_ERROR_STOPPED 0x06
- #define EC_STREAM_ERROR_STILLPLAYING 0x07
- // ( HRESULT, DWORD ) : application
- // lParam 1 is major code, lParam2 is minor code, either may be zero.
- #define EC_ERROR_STILLPLAYING 0x08
- // ( HRESULT, void ) : application
- // The filter graph manager may issue Run's to the graph asynchronously.
- // If such a Run fails, EC_ERROR_STILLPLAYING is issued to notify the
- // application of the failure. The state of the underlying filters
- // at such a time will be indeterminate - they will all have been asked
- // to run, but some are almost certainly not.
- #define EC_PALETTE_CHANGED 0x09
- // ( void, void ) : application
- // notify application that the video palette has changed
- #define EC_VIDEO_SIZE_CHANGED 0x0A
- // ( DWORD, void ) : application
- // Sent by video renderers.
- // Notifies the application that the native video size has changed.
- // LOWORD of the DWORD is the new width, HIWORD is the new height.
- #define EC_QUALITY_CHANGE 0x0B
- // ( void, void ) : application
- // Notify application that playback degradation has occurred
- #define EC_SHUTTING_DOWN 0x0C
- // ( void, void ) : internal
- // This message is sent by the filter graph manager to any plug-in
- // distributors which support IMediaEventSink to notify them that
- // the filter graph is starting to shutdown.
- #define EC_CLOCK_CHANGED 0x0D
- // ( void, void ) : application
- // Notify application that the clock has changed.
- // (i.e. SetSyncSource has been called on the filter graph and has been
- // distributed successfully to the filters in the graph.)
- #define EC_PAUSED 0x0E
- // ( HRESULT, void ) : application
- // Notify application the previous pause request has completed
- #define EC_OPENING_FILE 0x10
- #define EC_BUFFERING_DATA 0x11
- // ( BOOL, void ) : application
- // lParam1 == 1 --> starting to open file or buffer data
- // lParam1 == 0 --> not opening or buffering any more
- // (This event does not appear to be used by ActiveMovie.)
- #define EC_FULLSCREEN_LOST 0x12
- // ( void, IBaseFilter * ) : application
- // Sent by full screen renderers when switched away from full screen.
- // IBaseFilter may be NULL.
- #define EC_ACTIVATE 0x13
- // ( BOOL, IBaseFilter * ) : internal
- // Sent by video renderers when they lose or gain activation.
- // lParam1 is set to 1 if gained or 0 if lost
- // lParam2 is the IBaseFilter* for the filter that is sending the message
- // Used for sound follows focus and full-screen switching
- #define EC_NEED_RESTART 0x14
- // ( void, void ) : defaulted
- // Sent by renderers when they regain a resource (e.g. audio renderer).
- // Causes a restart by Pause/put_Current/Run (if running).
- #define EC_WINDOW_DESTROYED 0x15
- // ( IBaseFilter *, void ) : internal
- // Sent by video renderers when the window has been destroyed. Handled
- // by the filter graph / distributor telling the resource manager.
- // lParam1 is the IBaseFilter* of the filter whose window is being destroyed
- #define EC_DISPLAY_CHANGED 0x16
- // ( IPin *, void ) : internal
- // Sent by renderers when they detect a display change. the filter graph
- // will arrange for the graph to be stopped and the pin send in lParam1
- // to be reconnected. by being reconnected it allows a renderer to reset
- // and connect with a more appropriate format for the new display mode
- // lParam1 contains an (IPin *) that should be reconnected by the graph
- #define EC_STARVATION 0x17
- // ( void, void ) : defaulted
- // Sent by a filter when it detects starvation. Default handling (only when
- // running) is for the graph to be paused until all filters enter the
- // paused state and then run. Normally this would be sent by a parser or source
- // filter when too little data is arriving.
- #define EC_OLE_EVENT 0x18
- // ( BSTR, BSTR ) : application
- // Sent by a filter to pass a text string to the application.
- // Conventionally, the first string is a type, and the second a parameter.
- #define EC_NOTIFY_WINDOW 0x19
- // ( HWND, void ) : internal
- // Pass the window handle around during pin connection.
- #define EC_STREAM_CONTROL_STOPPED 0x1A
- // ( IPin * pSender, DWORD dwCookie )
- // Notification that an earlier call to IAMStreamControl::StopAt
- // has now take effect. Calls to the method can be marked
- // with a cookie which is passed back in the second parameter,
- // allowing applications to easily tie together request
- // and completion notifications.
- //
- // NB: IPin will point to the pin that actioned the Stop. This
- // may not be the pin that the StopAt was sent to.
- #define EC_STREAM_CONTROL_STARTED 0x1B
- // ( IPin * pSender, DWORD dwCookie )
- // Notification that an earlier call to IAMStreamControl::StartAt
- // has now take effect. Calls to the method can be marked
- // with a cookie which is passed back in the second parameter,
- // allowing applications to easily tie together request
- // and completion notifications.
- //
- // NB: IPin will point to the pin that actioned the Start. This
- // may not be the pin that the StartAt was sent to.
- #define EC_END_OF_SEGMENT 0x1C
- //
- // ( const REFERENCE_TIME *pStreamTimeAtEndOfSegment, DWORD dwSegmentNumber )
- //
- // pStreamTimeAtEndOfSegment
- // pointer to the accumulated stream clock
- // time since the start of the segment - this is directly computable
- // as the sum of the previous and current segment durations (Stop - Start)
- // and the rate applied to each segment
- // The source add this time to the time within each segment to get
- // a total elapsed time
- //
- // dwSegmentNumber
- // Segment number - starts at 0
- //
- // Notifies that a segment end has been reached when the
- // AM_SEEKING_Segment flags was set for IMediaSeeking::SetPositions
- // Passes in an IMediaSeeking interface to allow the next segment
- // to be defined by the application
- #define EC_SEGMENT_STARTED 0x1D
- //
- // ( const REFERENCE_TIME *pStreamTimeAtStartOfSegment, DWORD dwSegmentNumber)
- //
- // pStreamTimeAtStartOfSegment
- // pointer to the accumulated stream clock
- // time since the start of the segment - this is directly computable
- // as the sum of the previous segment durations (Stop - Start)
- // and the rate applied to each segment
- //
- // dwSegmentNumber
- // Segment number - starts at 0
- //
- // Notifies that a new segment has been started.
- // This is sent synchronously by any entity that will issue
- // EC_END_OF_SEGMENT when a new segment is started
- // (See IMediaSeeking::SetPositions - AM_SEEKING_Segment flag)
- // It is used to compute how many EC_END_OF_SEGMENT notifications
- // to expect at the end of a segment and as a consitency check
- #define EC_LENGTH_CHANGED 0x1E
- // (void, void)
- // sent to indicate that the length of the "file" has changed
- #define EC_DEVICE_LOST 0x1f
- // (IUnknown, 0)
- //
- // request window notification when the device is available again
- // (through WM_DEVICECHANGED messages registered with
- // RegisterDeviceNotification; see IAMDeviceRemoval interface)
- #define EC_STEP_COMPLETE 0x24
- // (BOOL bCacelled, void)
- // Step request complete
- // if bCancelled is TRUE the step was cancelled. This can happen
- // if the application issued some control request or because there
- // was a mode change etc etc
- #define EC_SKIP_FRAMES 0x25
- // ( nFramesToSkip, void ) : internal
- // Get the filter graph to seek accuratley.
- #define EC_TIMECODE_AVAILABLE 0x30
- // Sent by filter supporting timecode
- // Param1 has a pointer to the sending object
- // Param2 has the device ID of the sending object
- #define EC_EXTDEVICE_MODE_CHANGE 0x31
- // Sent by filter supporting IAMExtDevice
- // Param1 has the new mode
- // Param2 has the device ID of the sending object
- #define EC_GRAPH_CHANGED 0x50
- // Sent by filter to notify interesting graph changes
- #define EC_CLOCK_UNSET 0x51
- // ( void, void ) : application
- // Used to notify the filter graph to unset the current graph clock.
- // Has the affect of forcing the filter graph to reestablish the graph clock
- // on the next Pause/Run (note that this is only used by ksproxy, when the pin
- // of a clock providing filter is disconnected)
- //------------------------------------------
- //
- // WindowsMedia SDK filter-specific events:
- //
- #define EC_WMT_EVENT_BASE 0x0251
- //
- #define EC_WMT_INDEX_EVENT EC_WMT_EVENT_BASE
- // WindowsMedia SDK-originated file indexing status, sent by WMSDK-based filters
- //
- // lParam1 is one of the enum WMT_STATUS messages listed below, sent by the WindowsMedia SDK
- // lParam2 is specific to the lParam event
- //
- // the following WMT_STATUS messages are sent for this event:
- // WMT_STARTED - lParam2 is 0
- // WMT_CLOSED - lParam2 is 0
- // WMT_INDEX_PROGRESS - lParam2 is a DWORD containing the progress percent complete
- //
- // end WMSDK-originated events
- //-----------------------------------------