DVR Events (Windows Embedded CE 6.0)
1/5/2010
The following table describes the types of events that are generated by the digital video recorder (DVR) engine.
| Event | Definition |
|---|---|
DVRENGINE_EVENT_BEGINNING_OF_PAUSE_BUFFER |
This event indicates that the user has rewound the content to the beginning of the buffer. This event is normally followed by a STREAMBUFFER_EC_RATE_CHANGED event which indicates that the DVR engine has reset the rate to 1. This event is generated when "bound to live" is in progress during a temporary recording or a permanent recording. If a temporary recording is in progress and the playback graph is paused, this event indicates that the user has hit the truncation point of the pause buffer, and the application must change the state of the playback graph in order to run. Parameter 1 in this event indicates why the beginning of the buffer was reached. These reasons may include rewind, slow-motion and pause, all of which allow the beginning of the buffer, or the truncation point of the buffer to catch up with playback location. |
DVRENGINE_EVENT_CAPTURE_TUNE_DETECTED |
This event indicates that the DVR engine was informed of a channel change, but has not received the new channel yet. This is an informational event that the application may choose to handle. |
DVRENGINE_EVENT_END_OF_PAUSE_BUFFER |
This event indicates that the user has fast forwarded the content to the end of the pause buffer. This event is normally followed by a STREAMBUFFER_EC_RATE_CHANGED event which indicates that the DVR engine has reset the rate to 1. This event is generated when "bound to live" is in progress during a temporary recording or a permanent recording. This is an informational event that the application may choose to handle. |
DVRENGINE_EVENT_PLAYBACK_TUNE_HANDLED |
This event indicates that the DVR engine has handled a tune. This event is only generated when the tuning response mode for the DVR engine is not ignore-tunes. This is an informational event that the application may choose to handle. |
DVRENGINE_EVENT_RECORDING_END_OF_STREAM |
This event is generated by the DVR engine after the DVR_SOURCE_EC_DOMPLETE_DONE event, which is generated when the renderer reaches the beginning or the end of the stream and playback is completely finished. This behavior occurs when a recording is loading or when a recording is in progress. Parameter 1 in this event indicates which end of the recording has been reached. .gif "Ee480343.note(en-US,WinEmbedded.60).gif") Note:
There is no guarantee that this event will be dispatched after the DVR_SOURCE_EC_COMPLETE_DONE event.
|
DVR_SOURCE_EC_COMPLETE_DONE |
This event indicates that all material up to the end-of-stream has been rendered. This event is also generated when the filter graph stops, where end-of-stream propagation has stopped. |
DVR_SOURCE_EC_COMPLETE_PENDING |
This event indicates that end-of-stream was seen by the DVR source filter. This is an informational event that the application may choose to handle. |
EC_STREAM_ERROR_STOPPED |
This event is dispatched if there was a catastrophic error. If this event is generated, the application must tear down and rebuild the system to recover. |
STREAMBUFFER_EC_RATE_CHANGED |
This event is generated whenever the DVR engine changes the rate after reaching the bounds of the pause buffer. |
STREAMBUFFER_EC_WRITE_FAILURE |
This event is generated when writing to the hard disk fails. Writing to the hard disk may fail due to the hard disk being full, or due to a hard disk error. If this event is generated, it means that the user experience has been affected, the temporary buffer or permanent recording is missing data, and playback of the content will suffer. This should be prevented by monitoring your usage of the hard disk and by maintaining enough open space on the hard disk to handle a full pause buffer. |
See Also
Concepts
Digital Video Recorder Architecture