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. 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

Other Resources

Adding a Digital Video Recorder