Initializes user-supplied memory as IppsPolyGF_8u context for future use.
Syntax
IppStatus ippsPolyGFInit_8u(const IppsGFSpec_8u* pGF, int maxDegree, ippsPoly_GF8u* pPoly);
Parameters
pGF |
Pointer to the context of the finite field to be used to define a polynomial. |
maxDegree |
The highest possible value of the polynomial degree. |
pPoly |
Pointer to the user-supplied buffer to be initialized as the ippsPoly_GF8u context. |
Description
This function is declared in the ippdi.h file. The function initializes the user-supplied buffer as the ippsPoly_GF8u context of the polynomial over the finite field GF(2m) specified by the pGF parameter. The context is necessary for all operations on a polynomial.
The buffer pointed by pPoly must have size that the function ippsPolyGFGetSize returns.
Note
The value of maxDegree for PolyGFInit must not exceed the value of the same parameter in the preceding call to PolyGFGetSize.
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. |
ippStsbadArgErr |
Indicates an error condition if the value of the parameter maxDegree is less than 0. |
ippStsContextMatchErr |
Indicates an error condition if the context pointed by pGF is not valid. |