Developer Reference

Contents

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 the
IppsGFpElement
context 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
d
) 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(
p
d
) field and perform operations with field elements.
The function does not check the binomial's irreducibility.
When calling the functions over the GF(
p
d
) 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:
  • extDeg
    > 8 or
    extDeg
    < 2.
  • method
    is not in agreement with other parameters.
ippStsOutOfRangeErr
Indicates an error condition if the length of the value defined in
pGroundElm
is not equal to that of an element of
pParentGF
.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.