Initializes the IppsGFPXQState context of the finite field GF(p^d^2).
Syntax
IppStatus ippsGFPXQInit(IppsGFPXQState *pGFpxq, IppsGFPXState *pGroundGFpx, const Ipp32u *pIrrPoly);
Parameters
pGFpxq |
Pointer to the context of the GF(p^d^2) field being initialized. |
pGroundGFpx |
Pointer to the context of the ground field GF(p^d). |
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 *pGFpxq associated with the IppsGFPXQState 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^2) 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^2) field, properly initialized IppsGFPState and IppsGFPXState contexts of the respective ground fields GF(p) and GF(p^d) are 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 IppsGFPXState context parameter does not match the operation. |