Adjust docstrings for CodecError.cs

This commit is contained in:
TSR Berry 2023-02-05 17:14:21 +01:00
parent a9dd203412
commit fcca8871fb
No known key found for this signature in database
GPG key ID: 52353C0A4CCA15E2

View file

@ -2,55 +2,74 @@
{ {
internal enum CodecErr internal enum CodecErr
{ {
/*!\brief Operation completed without error */ /// <summary>
/// Operation completed without error
/// </summary>
Ok, Ok,
/*!\brief Unspecified error */ /// <summary>
/// Unspecified error
/// </summary>
Error, Error,
/*!\brief Memory operation failed */ /// <summary>
/// Memory operation failed
/// </summary>
MemError, MemError,
/*!\brief ABI version mismatch */ /// <summary>
/// ABI version mismatch
/// </summary>
AbiMismatch, AbiMismatch,
/*!\brief Algorithm does not have required capability */ /// <summary>
/// Algorithm does not have required capability
/// </summary>
Incapable, Incapable,
/*!\brief The given bitstream is not supported. /// <summary>
* /// The given bitstream is not supported.
* The bitstream was unable to be parsed at the highest level. The decoder /// </summary>
* is unable to proceed. This error \ref SHOULD be treated as fatal to the /// <remarks>
* stream. */ /// The bitstream was unable to be parsed at the highest level.<br/>
/// The decoder is unable to proceed.<br/>
/// This error SHOULD be treated as fatal to the stream.
/// </remarks>
UnsupBitstream, UnsupBitstream,
/*!\brief Encoded bitstream uses an unsupported feature /// <summary>
* /// Encoded bitstream uses an unsupported feature
* The decoder does not implement a feature required by the encoder. This /// </summary>
* return code should only be used for features that prevent future /// <remarks>
* pictures from being properly decoded. This error \ref MAY be treated as /// The decoder does not implement a feature required by the encoder.<br/>
* fatal to the stream or \ref MAY be treated as fatal to the current GOP. /// This return code should only be used for features that prevent future
*/ /// pictures from being properly decoded.<br/>
/// <br/>
/// This error MAY be treated as fatal to the stream or MAY be treated as fatal to the current GOP.
/// </remarks>
UnsupFeature, UnsupFeature,
/*!\brief The coded data for this stream is corrupt or incomplete /// <summary>
* /// The coded data for this stream is corrupt or incomplete.
* There was a problem decoding the current frame. This return code /// </summary>
* should only be used for failures that prevent future pictures from /// <remarks>
* being properly decoded. This error \ref MAY be treated as fatal to the /// There was a problem decoding the current frame.<br/>
* stream or \ref MAY be treated as fatal to the current GOP. If decoding /// This return code should only be used
* is continued for the current GOP, artifacts may be present. /// for failures that prevent future pictures from being properly decoded.<br/>
*/ /// <br/>
CorruptFrame, /// This error MAY be treated as fatal to the stream or MAY be treated as fatal to the current GOP.<br/>
/// If decoding is continued for the current GOP, artifacts may be present.
/// </remarks>
CorruptFrame,
/*!\brief An application-supplied parameter is not valid. /// <summary>
* /// An application-supplied parameter is not valid.
*/ /// </summary>
InvalidParam, InvalidParam,
/*!\brief An iterator reached the end of list. /// <summary>
* /// An iterator reached the end of list.
*/ /// </summary>
ListEnd ListEnd
} }
} }