GFpxInitBinomial
GFpxInitBinomial
Initializes the context of a GF(p
d
) field.Syntax
IppStatus ippsGFpxInitBinomial(const IppsGFpState*
pParentGF
, int
extDeg
, const IppsGFpElement* const
pGroundElm
, const IppsGFpMethod*
method
, IppsGFpState*
pGFpx
);
Include Files
ippcp.h
Parameters
- pParentGF
- Pointer to the context of the finite field GF(p) being extended.
- extDeg
- Degree of the extension.
- pGroundElm
- Pointer to theIppsGFpElementcontext containing the trailing coefficient of the field binomial.
- method
- Pointer to the implementation of a basic arithmetic (methods) over GF(p).d
- pGFpx
- Pointer to the context of the GF(p) field being initialized.d
Description
This function initializes the memory buffer ) field and perform operations with field elements.
pGFpx
associated with the IppsGFpState
context and sets up the specific irreducible binomial. The initialized context is used in the functions that create contexts of elements of the GF(p
d
The function does not check the binomial's irreducibility.
When calling the functions over the GF() field, a properly initialized
p
d
pParentGF
context of the finite 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 isNULL.
- ippStsContextMatchErr
- Indicates an error condition if any of the context parameterspParentGFandpGroundElmdoes not match the operation.
- ippStsBadArgErr
- Indicates an error condition in the following cases:
- extDeg> 8 orextDeg< 2.
- methodis not in agreement with other parameters.
- ippStsOutOfRangeErr
- Indicates an error condition if the length of the value defined inpGroundElmis not equal to that of an element ofpParentGF.