GFPXQGet

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

Syntax

IppStatus ippsGFPXQGet(const IppsGFPXQState *pGFpxq, const Ipp32u **ppGroundGFpx, Ipp32u *pIrrPoly, Ipp32u *polyDegree, Ipp32u *polyLen, Ipp32u *elementLen);

Parameters

pGFpxq	Pointer to the context of the GF(`p^d^2`) field.
pGroundGFpx	Pointer to the ground field GF(`p^d`).
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^2`) element.

Description

This function is declared in the ippcp.h file. The function extracts parameters of the GF(p^d^2) field from the IppsGFPXQState context. You can get any combination of the following field parameters: a reference to the ground field GF(p^d), a copy of the irreducible polynomial, its degree and length, as well as the length of an element of the GF(p^d^2) field. To turn off extraction of a particular field 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 pGFpxq pointer is NULL.