Initializes the IppsGFPXState context of the finite field GF(p^d).
Syntax
IppStatus ippsGFPXInit(IppsGFPXState *pGFpx, IppsGFPState *pGroundGFp, Ipp32u degree, const Ipp32u *pIrrPoly);
Parameters
pGFpx |
Pointer to the context of the GF(p^d) field being initialized. |
pGroundGFp |
Pointer to the context of the ground field GF(p). |
degree |
The degree of the extension. |
pIrrPoly |
Pointer to the array with coefficients of the irreducible polynomial. |
Description
This function is declared in the ippcp.h file. The function initializes the memory buffer *pGFpx associated with the IppsGFPXState context and sets up the specific irreducible polynomial. The initialized context is used in the functions that create contexts of elements of the GF(p^d) field and perform operations with the field elements.
Note
The function does not check primality of the polynomial.
Important
While you are calling the functions over the GF(p^d) field, a properly initialized *pGroundGFp context of the ground field GF(p) is required.
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. |
ippStsContextMatchErr |
Indicates an error condition if the IppsGFPState context parameter does not match the operation. |