Developer Reference for Intel® Integrated Performance Primitives Cryptography 2018
Initializes the context of a GF(pd) field.
IppStatus ippsGFpxInitBinomial(const IppsGFpState* pParentGF, int extDeg, const IppsGFpElement* const pParentElm, const IppsGFpMethod* method, IppsGFpState* pGFpx);
ippcp.h
pParentGF |
Pointer to the context of the finite field GF(p) being extended. |
extDeg |
Degree of the extension. |
pParentElm |
Pointer to the IppsGFpElement context containing the trailing coefficient of the field binomial. |
method |
Pointer to the implementation of a basic arithmetic (methods) over GF(pd). |
pGFpx |
Pointer to the context of the GF(pd) field being initialized. |
This function initializes the memory buffer 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(pd) field and perform operations with field elements.
The function does not check the binomial's irreducibility.
When calling the functions over the GF(pd) field, a properly initialized pParentGF context of the finite field GF(p) is required.
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 any of the context parameters pParentGF and pParentElm does not match the operation. |
ippStsBadArgErr |
Indicates an error condition in the following cases:
|
ippStsOutOfRangeErr |
Indicates an error condition if the length of the value defined in pParentElm is not equal to that of an element of pParentGF. |