Developer Reference

Contents

GFpECGet

Extracts the parameters of an elliptic curve over a finite field from the context.

Syntax

IppStatus ippsGFpECGet(IppsGFpState** const
ppGF
, IppsGFpElement*
pA
, IppsGFpElement*
pB
, const IppsGFpECState*
pEC
);
Include Files
ippcp.h
Parameters
ppGF
Double pointer to the context of the elliptic curve underlying finite field.
pA
Pointer to a copy of the coefficient
A
of the equation defining the elliptic curve.
pB
Pointer to a copy of the coefficient
B
of the equation defining the elliptic curve.
pEC
Pointer to the context of the elliptic curve.
Description
This function extracts parameters of the elliptic curve from the input
IppsGFpECState
context. You can get any combination of the following parameters: a reference to the underlying field and copies of the
A
and
B
coefficients. To turn off extraction of a particular parameter of the elliptic curve, set the appropriate function parameter to
NULL
.
Return Values
ippStsNoErr
Indicates no error. Any other value indicates an error or warning.
ippStsNullPtrErr
Indicates an error condition if
pEC
is
NULL
.
ippStsContextMatchErr
Indicates an error condition in the following cases:
  • IppsGFpECState
    context parameter does not match the operation.
  • Either
    pA
    or
    pB
    is not zero and the corresponding context parameter does not match the operation.
ippStsOutOfRangeErr
Indicates an error if either
pA
or
pB
does not belong to the finite field over which the elliptic curve is initialized.

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