You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
222 lines
7.6 KiB
222 lines
7.6 KiB
/***************************************************************************
|
|
*
|
|
* Copyright (C) 2001-2002 Microsoft Corporation. All Rights Reserved.
|
|
*
|
|
* File: dp8sim.h
|
|
*
|
|
* Content: Header for using DP8Sim.
|
|
//@@BEGIN_MSINTERNAL
|
|
*
|
|
* History:
|
|
* Date By Reason
|
|
* ======== ======== =========
|
|
* 04/23/01 VanceO Created.
|
|
//@@END_MSINTERNAL
|
|
*
|
|
***************************************************************************/
|
|
|
|
|
|
|
|
#ifndef __DP8SIM_H__
|
|
#define __DP8SIM_H__
|
|
|
|
|
|
|
|
#include <ole2.h> // for DECLARE_INTERFACE and HRESULT
|
|
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* DP8Sim simulated service providers
|
|
*
|
|
****************************************************************************/
|
|
|
|
// {8D3F9E5E-A3BD-475b-9E49-B0E77139143C}
|
|
DEFINE_GUID(CLSID_NETWORKSIMULATOR_DP8SP_TCPIP,
|
|
0x8d3f9e5e, 0xa3bd, 0x475b, 0x9e, 0x49, 0xb0, 0xe7, 0x71, 0x39, 0x14, 0x3c);
|
|
|
|
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* DP8Sim control object class ID
|
|
*
|
|
****************************************************************************/
|
|
|
|
// {40530071-1A80-4420-9B74-6A73171B0876}
|
|
DEFINE_GUID(CLSID_DP8SimControl,
|
|
0x40530071, 0x1a80, 0x4420, 0x9b, 0x74, 0x6a, 0x73, 0x17, 0x1b, 0x8, 0x76);
|
|
|
|
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* DP8Sim Control interface ID
|
|
*
|
|
****************************************************************************/
|
|
|
|
// {9CC03740-A510-4bcc-A014-776304B6E0D9}
|
|
DEFINE_GUID(IID_IDP8SimControl,
|
|
0x9cc03740, 0xa510, 0x4bcc, 0xa0, 0x14, 0x77, 0x63, 0x4, 0xb6, 0xe0, 0xd9);
|
|
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* DP8Sim Control suggested packet header sizes
|
|
*
|
|
****************************************************************************/
|
|
|
|
#define DP8SIMPACKETHEADERSIZE_IP 20
|
|
#define DP8SIMPACKETHEADERSIZE_UDP 8
|
|
#define DP8SIMPACKETHEADERSIZE_IP_UDP (DP8SIMPACKETHEADERSIZE_IP + DP8SIMPACKETHEADERSIZE_UDP)
|
|
|
|
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* DP8Sim Control structures
|
|
*
|
|
****************************************************************************/
|
|
|
|
typedef struct _DP8SIM_PARAMETERS
|
|
{
|
|
DWORD dwSize; // size of this structure, must be filled in prior to calling GetAllParameters or SetAllParameters
|
|
DWORD dwFlags; // flags for this structure
|
|
DWORD dwPacketHeaderSize; // fixed underlying transport packet header size to add into calculations, or 0 to calculate based only on DirectPlay headers and payload
|
|
DWORD dwBandwidthBPS; // bandwidth in bytes per second, or 0 for no limit
|
|
FLOAT fPacketLossPercent; // percentage of packets to drop, between 0.0 and 100.0
|
|
DWORD dwMinLatencyMS; // minimum artificial latency, in milliseconds (on top of any caused by bandwidth settings)
|
|
DWORD dwMaxLatencyMS; // maximum artificial latency, in milliseconds (on top of any caused by bandwidth settings)
|
|
} DP8SIM_PARAMETERS, * PDP8SIM_PARAMETERS;
|
|
|
|
typedef struct _DP8SIM_STATISTICS
|
|
{
|
|
DWORD dwSize; // size of this structure, must be filled in prior to calling GetAllStatistics
|
|
DWORD dwFlags; // flags for this structure
|
|
DWORD dwTransmittedPackets; // number of packets sent/received
|
|
DWORD dwTransmittedBytes; // number of bytes sent/received
|
|
DWORD dwDroppedPackets; // number of packets intentionally dropped
|
|
DWORD dwDroppedBytes; // number of bytes intentionally dropped
|
|
DWORD dwTotalDelayMS; // total number of milliseconds delay added because of bandwidth limitations or random latency settings
|
|
} DP8SIM_STATISTICS, * PDP8SIM_STATISTICS;
|
|
|
|
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* DP8Sim Control application interfaces
|
|
*
|
|
****************************************************************************/
|
|
|
|
#undef INTERFACE
|
|
#define INTERFACE IDP8SimControl
|
|
DECLARE_INTERFACE_(IDP8SimControl, IUnknown)
|
|
{
|
|
/*** IUnknown methods ***/
|
|
STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
|
|
STDMETHOD_(ULONG,AddRef) (THIS) PURE;
|
|
STDMETHOD_(ULONG,Release) (THIS) PURE;
|
|
|
|
/*** IDP8SimControl methods ***/
|
|
STDMETHOD(Initialize) (THIS_ const DWORD dwFlags) PURE;
|
|
STDMETHOD(Close) (THIS_ const DWORD dwFlags) PURE;
|
|
STDMETHOD(GetAllParameters) (THIS_ DP8SIM_PARAMETERS * const pdp8spSend, DP8SIM_PARAMETERS * const pdp8spReceive, const DWORD dwFlags) PURE;
|
|
STDMETHOD(SetAllParameters) (THIS_ const DP8SIM_PARAMETERS * const pdp8spSend, const DP8SIM_PARAMETERS * const pdp8spReceive, const DWORD dwFlags) PURE;
|
|
STDMETHOD(GetAllStatistics) (THIS_ DP8SIM_STATISTICS * const pdp8ssSend, DP8SIM_STATISTICS * const pdp8ssReceive, const DWORD dwFlags) PURE;
|
|
STDMETHOD(ClearAllStatistics) (THIS_ const DWORD dwFlags) PURE;
|
|
};
|
|
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* DP8Sim Control application interface macros
|
|
*
|
|
****************************************************************************/
|
|
|
|
#if (! defined(__cplusplus) || defined(CINTERFACE))
|
|
|
|
#define IDP8SimControl_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
|
|
#define IDP8SimControl_AddRef(p) (p)->lpVtbl->AddRef(p)
|
|
#define IDP8SimControl_Release(p) (p)->lpVtbl->Release(p)
|
|
#define IDP8SimControl_Initialize(p,a) (p)->lpVtbl->Initialize(p,a)
|
|
#define IDP8SimControl_Close(p,a) (p)->lpVtbl->Close(p,a)
|
|
#define IDP8SimControl_GetAllParameters(p,a,b,c) (p)->lpVtbl->GetAllParameters(p,a,b,c)
|
|
#define IDP8SimControl_SetAllParameters(p,a,b,c) (p)->lpVtbl->SetAllParameters(p,a,b,c)
|
|
#define IDP8SimControl_GetAllStatistics(p,a,b,c) (p)->lpVtbl->GetAllStatistics(p,a,b,c)
|
|
#define IDP8SimControl_ClearAllStatistics(p,a) (p)->lpVtbl->ClearAllStatistics(p,a)
|
|
|
|
#else // C++
|
|
|
|
#define IDP8SimControl_QueryInterface(p,a,b) (p)->QueryInterface(a,b)
|
|
#define IDP8SimControl_AddRef(p) (p)->AddRef()
|
|
#define IDP8SimControl_Release(p) (p)->Release()
|
|
#define IDP8SimControl_Initialize(p,a) (p)->Initialize(a)
|
|
#define IDP8SimControl_Close(p,a) (p)->Close(a)
|
|
#define IDP8SimControl_GetAllParameters(p,a,b,c) (p)->GetAllParameters(p,a,b,c)
|
|
#define IDP8SimControl_SetAllParameters(p,a,b,c) (p)->SetAllParameters(p,a,b,c)
|
|
#define IDP8SimControl_GetAllStatistics(p,a,b,c) (p)->GetAllStatistics(p,a,b,c)
|
|
#define IDP8SimControl_ClearAllStatistics(p,a) (p)->ClearAllStatistics(p,a)
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* DP8Sim Control return codes
|
|
*
|
|
* Errors are represented by negative values and cannot be combined.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#define _DP8SIMH_FACILITY_CODE 0x015
|
|
#define _DP8SIMH_HRESULT_BASE 0xE000
|
|
|
|
#define MAKE_DP8SIMSUCCESS(code) MAKE_HRESULT(0, _DP8SIMH_FACILITY_CODE, (code + _DP8SIMH_HRESULT_BASE))
|
|
#define MAKE_DP8SIMFAILURE(code) MAKE_HRESULT(1, _DP8SIMH_FACILITY_CODE, (code + _DP8SIMH_HRESULT_BASE))
|
|
|
|
|
|
|
|
#define DP8SIM_OK S_OK
|
|
|
|
#define DP8SIMERR_ALREADYINITIALIZED MAKE_DP8SIMFAILURE(0x10)
|
|
#define DP8SIMERR_GENERIC E_FAIL
|
|
#define DP8SIMERR_INVALIDFLAGS MAKE_DP8SIMFAILURE(0x20)
|
|
#define DP8SIMERR_INVALIDOBJECT MAKE_DP8SIMFAILURE(0x30)
|
|
#define DP8SIMERR_INVALIDPARAM E_INVALIDARG
|
|
#define DP8SIMERR_INVALIDPOINTER E_POINTER
|
|
#define DP8SIMERR_MISMATCHEDVERSION MAKE_DP8SIMFAILURE(0x40)
|
|
#define DP8SIMERR_NOTINITIALIZED MAKE_DP8SIMFAILURE(0x50)
|
|
#define DP8SIMERR_OUTOFMEMORY E_OUTOFMEMORY
|
|
|
|
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // __DP8SIM_H__
|