GFPXGet

Extracts parameters of the finite field GF(p^d) from the input structure.

Syntax

IppStatus ippsGFPXGet(const IppsGFPXState *pGFpx, const Ipp32u **ppGroundGFp, Ipp32u *pIrrPoly, Ipp32u *polyDegree, Ipp32u *polyLen, Ipp32u *elementLen);

Parameters

pGFpx	Pointer to the context of the GF(`p^d`) field.
pGroundGFp	Pointer to the ground GF(`p`) field.
pIrrPoly	Pointer to the array with coefficients of the irreducible polynomial.
polyDegree	The degree of the polynomial.
polyLen	Length of the array with the coefficients of the polynomial.
elementLen	Length of a GF(`p^d`) element.

Description

This function is declared in the ippcp.h file. The function extracts parameters of the GF(p^d) field from the IppsGFPXState context. You can get any combination of the following field parameters: a reference to the ground field GF(p), a copy of the irreducible polynomial, its degree and length, as well as the length of an element of the GF(p^d) field. To turn off extraction of a particular function parameter, set the appropriate function parameter to NULL.

Return Values

ippStsNoErr	Indicates no error. Any other value indicates an error or warning.
ippStsNullPtrErr	Indicates an error condition if the pGFpx pointer is NULL.