Developer Reference

Contents

GFpECTstPointInSubgroup

Checks if a point belongs to a specified subgroup.

Syntax

IppStatus ippsGFpECTstPointInGroup(const IppsGFpECPoint*
pP
, IppECResult*
pResult
, IppsGFpECState*
pEC
, Ipp8u*
pScratchBuffer
);
Include Files
ippcp.h
Parameters
pP
Pointer to the
IppsGFpECPoint
context.
pResult
Pointer to the result received upon the check that the point belongs to the elliptic curve over the finite field.
pEC
Pointer to the context of the elliptic curve.
pScratchBuffer
Pointer to the scratch buffer; can be
NULL
.
Description
This function checks whether a point belongs to the pre-defined subgroup of the elliptic curve defined over the finite field. The result of the testing is returned in 
pResult
 and may have the following values:
ippECValid
The point is in the subgroup of the curve.
ippECPointOutOfGroup
The point is out of the subgroup.
If the pointer to the scratch buffer is NULL, the function uses a short internal buffer for computations.
Return Values
ippStsNoErr
Indicates no error. Any other value indicates an error or warning.
ippStsNullPtrErr
Indicates an error condition if any of the pointers
pP
,
pResult
, and
pEC
is
NULL
.
ippStsContextMatchErr
Indicates an error condition if any of the specified contexts does not match the operation.
ippStsOutOfRangeErr
Indicates an error condition if the point 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