Initializes the IppsGFPXECState context of the elliptic curve over the GF(p^d) field.
Syntax
IppStatus ippsGFPXECInit(IppsGFPXECState *pEC, const IppsGFPXElement *pA, const IppsGFPXElement *pB, const IppsGFPXElement *pX, const IppsGFPXElement *pY, const Ipp32u *pOrder, Ipp32u orderLen, Ipp32u cofactor, IppsGFPXState *pGFpx);
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. |
pGFpx |
Pointer to the context of the elliptic curve definition field GF(p^d). |
Description
This function is declared in the ippcp.h file. The function initializes the memory buffer *pEC associated with the IppsGFPXECState 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 pGFpx 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 GFPXECSet.
Important
While you are calling the arithmetic functions for the elliptic curve *pEC, properly initialized IppsGFPXState and IppsGFPState contexts of the definition field GF(p^d) and ground field GF(p) are 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 pGFpx pointers is NULL. |
ippStsContextMatchErr |
Indicates an error condition if any of the context parameters does not match the operation. |