Initializes user-supplied memory as IppsGFSpec_8u context for future use.
Syntax
IppStatus ippsGFInit_8u(int feBitSize, const Ipp8u* pPolynomial, IppsGFSpec_8u* pGF);
Parameters
feBitSize |
Size of the field element (in bits). |
pPolynomial |
Pointer to the polynomial generating the finite field. |
pGF |
Pointer to the finite field context to be initialized. |
Description
This function is declared in the ippdi.h file. The function initializes the user-supplied buffer as the context of the finite field GF(2feBitzise). The context is necessary for each operation over the field.
The buffer for the context must have size that the function GFGetSize returns.
The polynomial is represented as an array of elements having type Ipp8u and length (feBitSize+1). In Intel IPP, the lower index of an array corresponds to the lower power of the independent variable. For example, to define the polynomial f(x) = x3 + x + 1, use the array {1,1,0,1}.
Note
The value of feBitSize for GFInit must not exceed the value of the same parameter in the preceding call to GFGetSize.
Return Values
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 the value of the parameter feBitSize is less than 1 or greater than 8. |
ippStsBadArgErr |
Indicates an error condition if the value of the parameter pointed by pPolynomial is not irreducible. |