| 1 | Error return codes possible from libvorbis and libvorbisfile:
|
|---|
| 2 |
|
|---|
| 3 | All 'failure' style returns are <0; this either indicates a generic
|
|---|
| 4 | 'false' value (eg, ready? T or F) or an error condition. Code can
|
|---|
| 5 | safely just test for < 0, or look at the specific return code for more
|
|---|
| 6 | detail.
|
|---|
| 7 |
|
|---|
| 8 | *** Return codes:
|
|---|
| 9 |
|
|---|
| 10 | OV_FALSE The call returned a 'false' status (eg, ov_bitrate_instant
|
|---|
| 11 | can return OV_FALSE if playback is not in progress, and thus
|
|---|
| 12 | there is no instantaneous bitrate information to report.
|
|---|
| 13 |
|
|---|
| 14 | OV_HOLE libvorbis/libvorbisfile is alerting the application that
|
|---|
| 15 | there was an interruption in the data (one of: garbage
|
|---|
| 16 | between pages, loss of sync followed by recapture, or a
|
|---|
| 17 | corrupt page)
|
|---|
| 18 |
|
|---|
| 19 | OV_EREAD A read from media returned an error.
|
|---|
| 20 |
|
|---|
| 21 | OV_EFAULT Internal logic fault; indicates a bug or heap/stack
|
|---|
| 22 | corruption.
|
|---|
| 23 |
|
|---|
| 24 | OV_EIMPL The bitstream makes use of a feature not implemented in this
|
|---|
| 25 | library version.
|
|---|
| 26 |
|
|---|
| 27 | OV_EINVAL Invalid argument value.
|
|---|
| 28 |
|
|---|
| 29 | OV_ENOTVORBIS Bitstream/page/packet is not Vorbis data.
|
|---|
| 30 |
|
|---|
| 31 | OV_EBADHEADER Invalid Vorbis bitstream header.
|
|---|
| 32 |
|
|---|
| 33 | OV_EVERSION Vorbis version mismatch.
|
|---|
| 34 |
|
|---|
| 35 | OV_ENOTAUDIO Packet data submitted to vorbis_synthesis is not audio data.
|
|---|
| 36 |
|
|---|
| 37 | OV_EBADPACKET Invalid packet submitted to vorbis_synthesis.
|
|---|
| 38 |
|
|---|
| 39 | OV_EBADLINK Invalid stream section supplied to libvorbis/libvorbisfile,
|
|---|
| 40 | or the requested link is corrupt.
|
|---|
| 41 |
|
|---|
| 42 | OV_ENOSEEK Bitstream is not seekable.
|
|---|
| 43 |
|
|---|
| 44 |
|
|---|
| 45 | ****************************************************************
|
|---|
| 46 | *** Libvorbis functions that can return failure/error codes:
|
|---|
| 47 |
|
|---|
| 48 | int vorbis_analysis_headerout()
|
|---|
| 49 | OV_EIMPL
|
|---|
| 50 |
|
|---|
| 51 | int vorbis_analysis_wrote()
|
|---|
| 52 | OV_EINVAL
|
|---|
| 53 |
|
|---|
| 54 | int vorbis_synthesis_headerin()
|
|---|
| 55 | OV_ENOTVORBIS, OV_EVERSION, OV_EBADHEADER
|
|---|
| 56 |
|
|---|
| 57 | int vorbis_synthesis()
|
|---|
| 58 | OV_ENOTAUDIO, OV_EBADPACKET
|
|---|
| 59 |
|
|---|
| 60 | int vorbis_synthesis_read()
|
|---|
| 61 | OV_EINVAL
|
|---|
| 62 |
|
|---|
| 63 | ****************************************************************
|
|---|
| 64 | *** Libvorbisfile functions that can return failure/error codes:
|
|---|
| 65 |
|
|---|
| 66 | int ov_open_callbacks()
|
|---|
| 67 | OV_EREAD, OV_ENOTVORBIS, OV_EVERSION, OV_EBADHEADER, OV_FAULT
|
|---|
| 68 |
|
|---|
| 69 | int ov_open()
|
|---|
| 70 | OV_EREAD, OV_ENOTVORBIS, OV_EVERSION, OV_EBADHEADER, OV_FAULT
|
|---|
| 71 |
|
|---|
| 72 | long ov_bitrate()
|
|---|
| 73 | OV_EINVAL, OV_FALSE
|
|---|
| 74 |
|
|---|
| 75 | long ov_bitrate_instant()
|
|---|
| 76 | OV_FALSE
|
|---|
| 77 |
|
|---|
| 78 | ogg_int64_t ov_raw_total()
|
|---|
| 79 | OV_EINVAL
|
|---|
| 80 |
|
|---|
| 81 | ogg_int64_t ov_pcm_total()
|
|---|
| 82 | OV_EINVAL
|
|---|
| 83 |
|
|---|
| 84 | double ov_time_total()
|
|---|
| 85 | OV_EINVAL
|
|---|
| 86 |
|
|---|
| 87 | int ov_raw_seek()
|
|---|
| 88 | OV_ENOSEEK, OV_EINVAL, OV_BADLINK
|
|---|
| 89 |
|
|---|
| 90 | int ov_pcm_seek_page()
|
|---|
| 91 | OV_ENOSEEK, OV_EINVAL, OV_EREAD, OV_BADLINK, OV_FAULT
|
|---|
| 92 |
|
|---|
| 93 | int ov_pcm_seek()
|
|---|
| 94 | OV_ENOSEEK, OV_EINVAL, OV_EREAD, OV_BADLINK, OV_FAULT
|
|---|
| 95 |
|
|---|
| 96 | int ov_time_seek()
|
|---|
| 97 | OV_ENOSEEK, OV_EINVAL, OV_EREAD, OV_BADLINK, OV_FAULT
|
|---|
| 98 |
|
|---|
| 99 | int ov_time_seek_page()
|
|---|
| 100 | OV_ENOSEEK, OV_EINVAL, OV_EREAD, OV_BADLINK, OV_FAULT
|
|---|
| 101 |
|
|---|
| 102 | long ov_read()
|
|---|
| 103 | OV_HOLE, OV_EBADLINK
|
|---|
