Initializes the IppsGFPECState context of the elliptic curve over the GF(p) field.
Syntax
IppStatus ippsGFPECInit(IppsGFPECState *pEC, const IppsGFPElement *pA, const IppsGFPElement *pB, const IppsGFPElement *pX, const IppsGFPElement *pY, const Ipp32u *pOrder, Ipp32u orderLen, Ipp32u cofactor, IppsGFPState *pGFp);
Parameters
pEC |
Pointer to the context of the elliptic curve being initialized. |
pA |
Pointer to the A parameter of the elliptic curve. |
pB |
Pointer to the B parameter of the elliptic curve. |
pX, pY |
Pointers to the x and y coordinates of the base point of the elliptic curve. |
pOrder |
Pointer to the array storing the order of the base point. |
orderLen |
Length of the array storing the order of the base point. |
cofactor |
The value of the cofactor. |
pGFp |
Pointer to the context of the elliptic curve definition field GF(p). |
Description
This function is declared in the ippcp.h file. The function initializes the memory buffer *pEC associated with the IppsGFPECState context and sets up the specific parameters of the elliptic curve, if they are supplied. The initialized context is used in the functions that create contexts of points on the curve (elements of the group of points) and perform operations with the points.
Note
Only the pEC and pGFp parameters are required. You can omit the other parameters by setting their values to NULL or zero and set up the missing parameters of the elliptic curve later on by calling GFPECSet.
Important
While you are calling the arithmetic functions for the elliptic curve *pEC, a properly initialized *pGFp context of the definition 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 pEC or pGFp pointers is NULL. |
ippStsContextMatchErr |
Indicates an error condition if any of the context parameters does not match the operation. |