text: /*******************************************************************************
  * Copyright 2010-2019 Intel Corporation
  * All Rights Reserved.
  *
  * If this  software was obtained  under the  Intel Simplified  Software License,
  * the following terms apply:
  *
  * The source code,  information  and material  ("Material") contained  herein is
  * owned by Intel Corporation or its  suppliers or licensors,  and  title to such
  * Material remains with Intel  Corporation or its  suppliers or  licensors.  The
  * Material  contains  proprietary  information  of  Intel or  its suppliers  and
  * licensors.  The Material is protected by  worldwide copyright  laws and treaty
  * provisions.  No part  of  the  Material   may  be  used,  copied,  reproduced,
  * modified, published,  uploaded, posted, transmitted,  distributed or disclosed
  * in any way without Intel's prior express written permission.  No license under
  * any patent,  copyright or other  intellectual property rights  in the Material
  * is granted to  or  conferred  upon  you,  either   expressly,  by implication,
  * inducement,  estoppel  or  otherwise.  Any  license   under such  intellectual
  * property rights must be express and approved by Intel in writing.
  *
  * Unless otherwise agreed by Intel in writing,  you may not remove or alter this
  * notice or  any  other  notice   embedded  in  Materials  by  Intel  or Intel's
  * suppliers or licensors in any way.
  *
  *
  * If this  software  was obtained  under the  Apache License,  Version  2.0 (the
  * "License"), the following terms apply:
  *
  * You may  not use this  file except  in compliance  with  the License.  You may
  * obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
  *
  *
  * Unless  required  by   applicable  law  or  agreed  to  in  writing,  software
  * distributed under the License  is distributed  on an  "AS IS"  BASIS,  WITHOUT
  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  *
  * See the   License  for the   specific  language   governing   permissions  and
  * limitations under the License.
  *******************************************************************************/
  
  /*
  //
  //  Purpose:
  //     Intel(R) Integrated Performance Primitives. Cryptography Primitives.
  //     EC over GF(p) Operations
  //
  //     Context:
  //        ippsGFpECTstPoint()
  //
  */
  
  #include "owndefs.h"
  #include "owncp.h"
  #include "pcpgfpecstuff.h"
  #include "pcphash.h"
  #include "pcphash_rmf.h"
  
  /*F*
  // Name: ippsGFpECTstPoint
  //
  // Purpose: Checks if a point belongs to an elliptic curve
  //
  // Returns:                   Reason:
  //    ippStsNullPtrErr               pP == NULL
  //                                   pEC == NULL
  //                                   pResult == NULL
  //
  //    ippStsContextMatchErr          invalid pEC->idCtx
  //                                   invalid pP->idCtx
  //
  //    ippStsOutOfRangeErr            ECP_POINT_FELEN(pP)!=GFP_FELEN()
  //
  //    ippStsNoErr                    no error
  //
  // Parameters:
  //    pP          Pointer to the IppsGFpECPoint context
  //    pEC         Pointer to the context of the elliptic curve
  //    pResult     Pointer to the result of the check
  //
  // Note:
  //    Even if test passed is not a fact that the point belongs to BP-related subgroup BP
  //
  *F*/
  
  IPPFUN(IppStatus, ippsGFpECTstPoint,(const IppsGFpECPoint* pP,
                                       IppECResult* pResult,
                                       IppsGFpECState* pEC))
  {
     IPP_BAD_PTR3_RET(pP, pResult, pEC);
     pEC = (IppsGFpECState*)( IPP_ALIGNED_PTR(pEC, ECGFP_ALIGNMENT) );
     IPP_BADARG_RET( !ECP_TEST_ID(pEC), ippStsContextMatchErr );
     IPP_BADARG_RET( !ECP_POINT_TEST_ID(pP), ippStsContextMatchErr );
  
     IPP_BADARG_RET( ECP_POINT_FELEN(pP)!=GFP_FELEN(GFP_PMA(ECP_GFP(pEC))), ippStsOutOfRangeErr);
  
     if( gfec_IsPointAtInfinity(pP) )
        *pResult = ippECPointIsAtInfinite;
     else if( !gfec_IsPointOnCurve(pP, pEC) )
        *pResult = ippECPointIsNotValid;
     else
        *pResult = ippECValid;
  
     return ippStsNoErr;
  }
  