pvaltreestackapi.h

基于h323协议的软phone

/***********************************************************************
        Copyright (c) 2002 RADVISION Ltd.
************************************************************************
NOTICE:
This document contains information that is confidential and proprietary
to RADVISION Ltd.. No part of this document may be reproduced in any
form whatsoever without written prior approval by RADVISION Ltd..

RADVISION Ltd. reserve the right to revise this publication and make
changes without obligation to notify any person of such revisions or
changes.
***********************************************************************/

/*
  pvaltreeStackApi

  This file contains functions which are available for the use of the stack modules,
  but are not part of the API provided to the users

  */

#ifndef _PVALTREE_STACKAPI_H
#define _PVALTREE_STACKAPI_H

#include "pvaltreeDef.h"

#ifdef __cplusplus
extern "C" {
#endif


/************************************************************************
 * pvtCompareTree
 * purpose: Compare between two trees
 *          The trees must be structure identical, the compare function only
 *          checks that the values are identical.
 * input  : val1H       - PVT handle of the 1st tree
 *          val1RootId  - Root ID of the 1st tree
 *          val2H       - PVT handle of the 2nd tree
 *          val2RootId  - Root ID of the 2nd tree
 * output : none
 * return : Non-negative value if trees are identical
 *          Negative value on failure
 ************************************************************************/
int pvtCompareTree(
    IN  HPVT            val1H,
    IN  RvPvtNodeId     val1RootId,
    IN  HPVT            val2H,
    IN  RvPvtNodeId     val2RootId);



RVAPI int RVCALLCONV
pvtAddChildsIfDiffer(
        IN  HPVT        destH,
        IN  RvPvtNodeId destParentId,
        IN  HPVT        srcH,
        IN  RvPvtNodeId srcParentId,
        IN  RvBool      move);

RVAPI int RVCALLCONV
pvtFindObject(
         IN  HPVT           hVal,
         IN  RvPvtNodeId    nodeId,
         IN  HPST           hSyn,
         IN  int            stNodeIdOfAT,
         OUT int*           objectId);


/************************************************************************
 * pvtPrintInternal
 * purpose: Print a tree from a given node.
 *          This function should be used internally instead of using
 *          pvtPrintStd().
 * input  : valH        - Value Tree handle
 *          parentId    - node ID to start printing from
 *          logHandle   - Log source to print to
 *          level       - Debug level to use for printing
 *                        0,1 - None
 *                        2 - Print the tree
 *                        3 - Print all values in the tree (even the irrelevant onse)
 * output : none
 * return : Non-negative value on success
 *          Negative value on failure
 ************************************************************************/
RVAPI
int RVCALLCONV pvtPrintInternal(
    IN  HPVT            valH,
    IN  RvPvtNodeId     parentId,
    IN  RvLogSource*    logHandle,
    IN  int             level);



#ifdef __cplusplus
}
#endif

#endif  /* _PVALTREE_STACKAPI_H */