Developer Reference

Contents

GFpECInit

Initializes the context of an elliptic curve over a finite field.

Syntax

IppStatus ippsGFpECInit(const IppsGFpState*
pGF
, const IppsGFpElement*
pA
, const IppsGFpElement*
pB
, IppsGFpECState*
pEC
);
Include Files
ippcp.h
Parameters
pGF
Pointer to the
IppsGFpState
context of the underlying finite field.
pA
Pointer to the coefficient
A
of the equation defining the elliptic curve.
pB
Pointer to the coefficient
B
of the equation defining the elliptic curve.
pEC
Pointer to the context of the elliptic curve being initialized.
Description
This function initializes the memory buffer
pEC
associated with the
IppsGFpECState
context and sets up the parameters of the elliptic curve if they are supplied. The initialized context is used in functions that create contexts of points on the curve (elements of the group of points) and perform operations with the points.
Only the 
pEC
 and 
pGF
 parameters are required. You can omit the other parameters by setting their values to 
NULL
 or zero and set them up later on by calling 
GFpECSet
or 
GFpECSetSubGroup
.
When calling arithmetic functions for the elliptic curve defined by 
pEC
, a properly initialized 
pGF
 context of the underlying field is required.
Return Values
ippStsNoErr
Indicates no error. Any other value indicates an error or warning.
ippStsNullPtrErr
Indicates an error condition if either
pEC
or
pGF
is
NULL
.
ippStsContextMatchErr
Indicates an error condition in the following cases:
  • IppsGFpState
    context parameter does not match the operation.
  • pA
    or
    pB
    is not zero and the corresponding context parameter does not match the operation.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804