Visible to Intel only — GUID: GUID-2EF620ED-9970-4C8A-8B97-DD34C8EEFC61
Visible to Intel only — GUID: GUID-2EF620ED-9970-4C8A-8B97-DD34C8EEFC61
GFpxInitBinomial
Initializes the context of a GF(pd) 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 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. |
Description
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.
Important
When calling the functions over the GF(pd) field, a properly initialized 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 is NULL. |
ippStsContextMatchErr |
Indicates an error condition if any of the context parameters pParentGF and pGroundElm 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 pGroundElm is not equal to that of an element of pParentGF. |