Initializes user-supplied memory as the IppsRSEncodeSpec_8u context for future use.
IppStatus ippsRSEncodeInit_8u(int codeLength, int dataLength, const IppsGFSpec_8u* pGF, Ipp8u root, IppsRSEncodeSpec_8u* pRS);
codeLength |
The desired codeword length. |
dataLength |
The desired data length. |
pGF |
Pointer to the context of the finite field (GF) to be used for the encoding operation. |
root |
The root of the (first) minimal polynomial over GF. |
pRS |
Pointer to the user-supplied buffer to be initialized as the IppsRSEncodeSpec_8u context. |
This function is declared in the ippdi.h file. The function initializes the user-supplied buffer as the RS(codeLength, dataLength) encoder context.
The buffer for the context must have size that the function ippsRSEncodeGetSize returns.
The codeLength and dataLength parameters for ippsRSEncodeInit must have the same values as in the preceding call to ippsRSEncodeGetSize. The root value defines the generating polynomial g(x) of RS(codeLength, dataLength):
g(x) = (x-root)*( x-root *a1) *( x-root *a2)*...*( x-root *a(2*t-1)),
where t is the error-correcting ability, such that 2*t = codeLength - dataLength.
ippStsNoErr |
Indicates no error. Any other value indicates an error or warning. |
ippStsNullPtrErr |
Indicates an error condition if any of the specified pointers is NULL. |
ippStsRangeErr |
Indicates an error condition if values of the parameters codeLength and/or dataLength are out of bounds determined by the inequalities: 2 ≤ codeLength < orderof(GF); 0 < dataLength < codeLength. |
ippStsBadArgErr |
Indicates an error condition if the value of the parameter root is not a valid element of the finite field or is equal to 0. |
Copyright © 2000 - 2010, Intel Corporation. All rights reserved.