CXPSession.h

/* START_LICENSE_HEADER

Copyright (C) 2000 Martin Piper, original design and program code
Copyright (C) 2001 Replica Software

This program file is copyright (C) Replica Software and can only be used under license.
For more information visit: http://www.replicanet.com/
Or email: info@replicanet.com

END_LICENSE_HEADER */
#include "RNPlatform/Inc/MemoryTracking.h"
#ifndef __CXPSESSION_H__
#define __CXPSESSION_H__

#ifdef __cplusplus
extern "C"
{
#endif

#ifndef __XPSESSION_H__

/* Declare some defines for types used internal to XPSession */
#define kXPSessionUnknownID  (-1)
#define kXPSessionBroadcastID (-2)

/* These are the internal message types for session messages */
#define kXPSessionPacketType_Unreliable     (0)
#define kXPSessionPacketType_Reliable       (1<<0)
#define kXPSessionPacketType_Certain        (1<<1)

/* Error values */
#define kXPSession_EOK (0)
#define kXPSession_EERROR (-1)
#define kXPSession_ETRANSPORT_CLOSED (-2)
#define kXPSession_ETRANSPORT_ERROR (-3)

#define kTransportAnyGameChannel (0)

#endif

/* The type define for the handle that has to be passed in to each function so that the API knows what session you are trying to access */
typedef struct sCXPSession *hCXPSession;

/* What follows are 'C' style function wrappers for the C++ class */

hCXPSession CXPSession_Allocate(void);

void CXPSession_Free(const hCXPSession handle);

void CXPSession_Create(const hCXPSession handle,const char *name);

void CXPSession_CreateWithProtocol(const hCXPSession handle,const char *name,const char *protocols);

void CXPSession_ExportURL(const hCXPSession handle,char *nameBuffer,const int length);

void CXPSession_Join(const hCXPSession handle,const char *url);

void CXPSession_Find(const hCXPSession handle);

void CXPSession_FindWithProtocols(const hCXPSession handle,const char *protocols);

int CXPSession_EnumerateFound(const hCXPSession handle,char *nameBuffer,const int length);

int CXPSession_GetGameChannel(const hCXPSession handle);

void CXPSession_SetGameChannel(const hCXPSession handle,const int channel);

int CXPSession_GetSessionID(const hCXPSession handle);

int CXPSession_IsStable(const hCXPSession handle);

int CXPSession_GetStatus(const hCXPSession handle);

void CXPSession_DataSendToSessionUnreliable(const hCXPSession handle,const int sessionid,const char *data,const int length);

void CXPSession_DataSendToSessionReliable(const hCXPSession handle,const int sessionid,const char *data,const int length);

void CXPSession_DataSendToSessionCertain(const hCXPSession handle,const int sessionid,const char *data,const int length);

int CXPSession_DataReceive(const hCXPSession handle,int *const fromsessionid,char *const data,int *const length,unsigned char *const type);

int CXPSession_IsMaster(const hCXPSession handle);

int CXPSession_GetJoiner(const hCXPSession handle);

int CXPSession_GetLeaver(const hCXPSession handle);

double CXPSession_GetTime(const hCXPSession handle);

double CXPSession_GetLocalTime(const hCXPSession handle);

float CXPSession_GetNetworkSendRate(const hCXPSession handle);

float CXPSession_GetNetworkReceiveRate(const hCXPSession handle);

int CXPSession_GetNetworkPacketsLost(const hCXPSession handle);

void CXPSession_Poll(const hCXPSession handle);

void CXPSession_SetManualPoll(const hCXPSession handle);

void CXPSession_SetAutomaticPoll(const hCXPSession handle);

void CXPSession_SetManualPollXPURL(const hCXPSession handle);

void CXPSession_SetAutomaticPollXPURL(const hCXPSession handle);


void CXPSession_SetCanSpider(const hCXPSession handle,const int canSpider);

int CXPSession_GetCanSpider(const hCXPSession handle);

void CXPSession_SetCanBecomeMaster(const hCXPSession handle,const int canBeMaster);

int CXPSession_GetCanBecomeMaster(const hCXPSession handle);

float CXPSession_GetLatencyToMasterSession(const hCXPSession handle);

void CXPSession_SetLatencyRecalculationDelay(const hCXPSession handle,const float seconds);

void CXPSession_SetEncryption(const hCXPSession handle,const int enable);

int CXPSession_GetEncryption(const hCXPSession handle);

void CXPSession_Disconnect(const hCXPSession handle,const int sessionID);

int CXPSession_GetPreConnectStatus(const hCXPSession handle);

void CXPSession_SetPreConnect(const hCXPSession handle,const int enable);

int CXPSession_GetPreConnect(const hCXPSession handle);

void CXPSession_PreConnectHasFinished(const hCXPSession handle);

void CXPSession_SetAutomaticPacketCompression(const hCXPSession handle,const int enable);

int CXPSession_GetAutomaticPacketCompression(const hCXPSession handle);

void CXPSession_GetCompressionStatistics(const hCXPSession handle,int *const before,int *const after,const int reset);

void CXPSession_GetMergedStatistics(const hCXPSession handle,int *const sent,int *const received,const int reset);

int CXPSession_GetMasterSessionID(const hCXPSession handle);

int CXPSession_GetURLFromSessionID(const hCXPSession handle,const int sessionID,char *const url,const int urlLen);

void CXPSession_SetClientOnly(const hCXPSession handle,const int isClient);

int CXPSession_GetClientOnly(const hCXPSession handle);

int CXPSession_GetBandwidthFromSessionID(const hCXPSession handle,const int sessionID,int *const bandwidth,int *const output,int *const input);

#ifdef __cplusplus
}
#endif

#endif