Notification events
The filter reports its asynchronous events to the graph through the standard DirectShow IMediaEventEx mechanism, with a custom event code:
#define EC_RTSPNOTIFY (EC_USER + 0x4000)
The application receives EC_RTSPNOTIFY (param1, param2): param1 identifies the event, param2 carries the value described below.
| param1 | Value | Meaning |
|---|---|---|
| EC_RTSP_PARAM1_DISKFULL | 1 | the recording stopped: the destination disk is full |
| EC_RTSP_PARAM1_DEVICELOST_SHUTDOWN | 2 | the source was lost and the automatic reconnection is disabled: the graph stops |
| EC_RTSP_PARAM1_DEVICELOST_RECONNECTING | 3 | the source was lost and the filter is reconnecting, see Auto reconnection |
| EC_RTSP_PARAM1_DEVICELOST_RECONNECTED | 4 | the reconnection succeeded and the graph is running again |
| EC_RTSP_PARAM1_RECORDTONEWFILE_COMPLETED | 5 | the previous recording file was closed after a RTSP_Action_RecordToNewFileNow |
| EC_RTSP_PARAM1_OPENURLASYNC_CONNECTION_RESULT | 6 | an asynchronous connection completed; param2 = 1 on success, 0 on failure, see DirectShow configuration |
| EC_RTSP_PARAM1_FRAME_CAPTURE_SUCCEEDED | 7 | a frame capture succeeded; when the capture was requested with the "HBITMAP" keyword, param2 is the bitmap handle |
| EC_RTSP_PARAM1_FRAME_CAPTURE_FAILED | 8 | the frame capture failed |
| EC_RTSP_PARAM1_ONVIF_SNAPSHOT_SUCCEEDED | 9 | an asynchronous ONVIF snapshot succeeded, see ONVIF JPEG snapshot |
| EC_RTSP_PARAM1_ONVIF_SNAPSHOT_FAILED | 10 | the asynchronous ONVIF snapshot failed |
| EC_RTSP_DURATION_UPDATED | 11 | the duration of the source was updated |
| EC_RTSP_RESERVED1_OLD_EVAL_TIMEOUT | 12 | reserved, kept for compatibility |
| EC_RTSP_PARAM1_RTSP_CONNECTED_BUT_NOT_RECEIVING | 13 | the connection to the source succeeded, but no data is being received. A different RTSP transport mode often solves this |
| EC_RTSP_PARAM1_RTSP_ERROR_OUTOFMEM | 14 | out of memory |
| EC_RTSP_PARAM1_RTSP_ERROR_WRITE | 15 | a write error occurred on the recording file |
| EC_RTSP_PARAM1_RECORDTONEWFILE_STARTED | 16 | the new recording file was opened and is being written |
| EC_RTSP_EVAL_TIMEOUT | 17 | evaluation version only: the 2-minute recording timeout expired |
| EC_RTSP_PARAM1_BACKCHANNEL_RECONNECTING | 18 | backchannel filter: the connection was lost and is being retried; param2 = attempt number |
| EC_RTSP_PARAM1_BACKCHANNEL_RECONNECTED | 19 | backchannel filter: the reconnection succeeded; param2 = attempt number |
| EC_RTSP_PARAM1_BACKCHANNEL_CONNECTION_LOST | 20 | backchannel filter: the connection was lost and the automatic reconnection is disabled. The graph stops |
| EC_RTSP_PARAM1_BACKCHANNEL_ERROR | 21 | backchannel filter: an error occurred |
Note
The standard DirectShow EC_DEVICE_LOST event is also sent when the source is lost and the automatic reconnection is disabled.