308 lines
11 KiB
C
308 lines
11 KiB
C
/*==========================================================================;
|
|
*
|
|
* Copyright (C) 1994-1995 Microsoft Corporation. All Rights Reserved.
|
|
*
|
|
* File: dplay.h
|
|
* Content: DirectPlay include file
|
|
*
|
|
***************************************************************************/
|
|
|
|
#ifndef __DPLAY_INCLUDED__
|
|
#define __DPLAY_INCLUDED__
|
|
#ifdef _WIN32
|
|
/* for DECLARE_INTERFACE and HRESULT. */
|
|
#include <ole2.h>
|
|
#endif
|
|
|
|
#define _FACDP 0x877
|
|
#define MAKE_DPHRESULT( code ) MAKE_HRESULT( 1, _FACDP, code )
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#pragma pack(push, 1)
|
|
|
|
|
|
/*============================================================================
|
|
*
|
|
* DirectPlay Structures
|
|
*
|
|
* Various structures used to invoke DirectPlay.
|
|
*
|
|
*==========================================================================*/
|
|
|
|
#ifdef __cplusplus
|
|
/* 'struct' not 'class' per the way DECLARE_INTERFACE_ is defined */
|
|
struct IDirectPlay;
|
|
typedef struct IDirectPlay FAR *LPDIRECTPLAY;
|
|
#else
|
|
typedef struct IDirectPlay FAR *LPDIRECTPLAY;
|
|
#endif
|
|
|
|
typedef DWORD DPID, FAR *LPDPID;
|
|
|
|
typedef struct _DPCAPS
|
|
{
|
|
DWORD dwSize;
|
|
DWORD dwFlags;
|
|
DWORD dwMaxBufferSize;
|
|
DWORD dwMaxQueueSize; // Function of DPlay, not SP.
|
|
DWORD dwMaxPlayers;
|
|
DWORD dwHundredBaud; // 24 is 2400, 96 is 9600, etc.
|
|
DWORD dwLatency;
|
|
} DPCAPS;
|
|
|
|
typedef DPCAPS FAR *LPDPCAPS;
|
|
|
|
#define DPLONGNAMELEN 52
|
|
#define DPSHORTNAMELEN 20
|
|
#define DPSESSIONNAMELEN 32
|
|
#define DPPASSWORDLEN 16
|
|
#define DPUSERRESERVED 16
|
|
|
|
typedef struct
|
|
{
|
|
DWORD dwSize;
|
|
GUID guidSession; // Id for Game. Null is all games.
|
|
DWORD dwSession; // session identifier
|
|
DWORD dwMaxPlayers; // Maximum players allowed in game.
|
|
DWORD dwCurrentPlayers; // Current players in Game.
|
|
DWORD dwFlags; // DPOPEN_* flags
|
|
char szSessionName[DPSESSIONNAMELEN];// Human readable name for Game
|
|
char szUserField[DPUSERRESERVED];
|
|
DWORD dwReserved1; // Reserved for future MS use.
|
|
char szPassword[DPPASSWORDLEN]; // Password to be allowed into game.
|
|
DWORD dwReserved2; // Reserved for future MS use.
|
|
DWORD dwUser1;
|
|
DWORD dwUser2;
|
|
DWORD dwUser3;
|
|
DWORD dwUser4;
|
|
} DPSESSIONDESC;
|
|
typedef DPSESSIONDESC FAR *LPDPSESSIONDESC;
|
|
|
|
|
|
/*
|
|
* Create API
|
|
*/
|
|
typedef BOOL (FAR PASCAL * LPDPENUMDPCALLBACK)(
|
|
LPGUID lpSPGuid,
|
|
LPSTR lpFriendlyName,
|
|
DWORD dwMajorVersion,
|
|
DWORD dwMinorVersion,
|
|
LPVOID lpContext);
|
|
|
|
typedef BOOL (FAR PASCAL * LPDPENUMSESSIONSCALLBACK)(
|
|
LPDPSESSIONDESC lpDPSGameDesc,
|
|
LPVOID lpContext,
|
|
LPDWORD lpdwTimeOut,
|
|
DWORD dwFlags);
|
|
|
|
|
|
|
|
extern HRESULT WINAPI DirectPlayCreate( LPGUID lpGUID, LPDIRECTPLAY FAR *lplpDP, IUnknown FAR *pUnk);
|
|
extern HRESULT WINAPI DirectPlayEnumerate( LPDPENUMDPCALLBACK, LPVOID );
|
|
|
|
|
|
/* Player enumeration callback prototype */
|
|
typedef BOOL (FAR PASCAL *LPDPENUMPLAYERSCALLBACK)(
|
|
DPID dpId,
|
|
LPSTR lpFriendlyName,
|
|
LPSTR lpFormalName,
|
|
DWORD dwFlags,
|
|
LPVOID lpContext );
|
|
|
|
/*
|
|
* IDirectPlay
|
|
*/
|
|
#undef INTERFACE
|
|
#define INTERFACE IDirectPlay
|
|
#ifdef _WIN32
|
|
DECLARE_INTERFACE_( IDirectPlay, IUnknown )
|
|
{
|
|
/*** IUnknown methods ***/
|
|
STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
|
|
STDMETHOD_(ULONG,AddRef) (THIS) PURE;
|
|
STDMETHOD_(ULONG,Release) (THIS) PURE;
|
|
/*** IDirectPlay methods ***/
|
|
STDMETHOD(AddPlayerToGroup) (THIS_ DPID, DPID) PURE;
|
|
STDMETHOD(Close) (THIS) PURE;
|
|
STDMETHOD(CreatePlayer) (THIS_ LPDPID,LPSTR,LPSTR,LPHANDLE) PURE;
|
|
STDMETHOD(CreateGroup) (THIS_ LPDPID,LPSTR,LPSTR) PURE;
|
|
STDMETHOD(DeletePlayerFromGroup)(THIS_ DPID,DPID) PURE;
|
|
STDMETHOD(DestroyPlayer) (THIS_ DPID) PURE;
|
|
STDMETHOD(DestroyGroup) (THIS_ DPID) PURE;
|
|
STDMETHOD(EnableNewPlayers) (THIS_ BOOL) PURE;
|
|
STDMETHOD(EnumGroupPlayers) (THIS_ DPID, LPDPENUMPLAYERSCALLBACK,LPVOID,DWORD) PURE;
|
|
STDMETHOD(EnumGroups) (THIS_ DWORD, LPDPENUMPLAYERSCALLBACK,LPVOID,DWORD) PURE;
|
|
STDMETHOD(EnumPlayers) (THIS_ DWORD, LPDPENUMPLAYERSCALLBACK,LPVOID,DWORD) PURE;
|
|
STDMETHOD(EnumSessions) (THIS_ LPDPSESSIONDESC,DWORD,LPDPENUMSESSIONSCALLBACK,LPVOID,DWORD) PURE;
|
|
STDMETHOD(GetCaps) (THIS_ LPDPCAPS) PURE;
|
|
STDMETHOD(GetMessageCount) (THIS_ DPID, LPDWORD) PURE;
|
|
STDMETHOD(GetPlayerCaps) (THIS_ DPID, LPDPCAPS) PURE;
|
|
STDMETHOD(GetPlayerName) (THIS_ DPID,LPSTR,LPDWORD,LPSTR,LPDWORD) PURE;
|
|
STDMETHOD(Initialize) (THIS_ LPGUID) PURE;
|
|
STDMETHOD(Open) (THIS_ LPDPSESSIONDESC) PURE;
|
|
STDMETHOD(Receive) (THIS_ LPDPID,LPDPID,DWORD,LPVOID,LPDWORD) PURE;
|
|
STDMETHOD(SaveSession) (THIS_ LPSTR) PURE;
|
|
STDMETHOD(Send) (THIS_ DPID, DPID, DWORD, LPVOID, DWORD) PURE;
|
|
STDMETHOD(SetPlayerName) (THIS_ DPID,LPSTR,LPSTR) PURE;
|
|
};
|
|
#endif
|
|
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* DIRECTPLAY ERRORS
|
|
*
|
|
* Errors are represented by negative values and cannot be combined.
|
|
*
|
|
****************************************************************************/
|
|
#define DP_OK 0
|
|
#define DPERR_ALREADYINITIALIZED MAKE_DPHRESULT( 5 )
|
|
#define DPERR_ACCESSDENIED MAKE_DPHRESULT( 10 )
|
|
#define DPERR_ACTIVEPLAYERS MAKE_DPHRESULT( 20 )
|
|
#define DPERR_BUFFERTOOSMALL MAKE_DPHRESULT( 30 )
|
|
#define DPERR_CANTADDPLAYER MAKE_DPHRESULT( 40 )
|
|
#define DPERR_CANTCREATEGROUP MAKE_DPHRESULT( 50 )
|
|
#define DPERR_CANTCREATEPLAYER MAKE_DPHRESULT( 60 )
|
|
#define DPERR_CANTCREATESESSION MAKE_DPHRESULT( 70 )
|
|
#define DPERR_CAPSNOTAVAILABLEYET MAKE_DPHRESULT( 80 )
|
|
#define DPERR_EXCEPTION MAKE_DPHRESULT( 90 )
|
|
#define DPERR_GENERIC E_FAIL
|
|
|
|
#define DPERR_INVALIDFLAGS MAKE_DPHRESULT( 120 )
|
|
#define DPERR_INVALIDOBJECT MAKE_DPHRESULT( 130 )
|
|
#define DPERR_INVALIDPARAM E_INVALIDARG
|
|
#define DPERR_INVALIDPARAMS DPERR_INVALIDPARAM
|
|
#define DPERR_INVALIDPLAYER MAKE_DPHRESULT( 150 )
|
|
#define DPERR_NOCAPS MAKE_DPHRESULT( 160 )
|
|
#define DPERR_NOCONNECTION MAKE_DPHRESULT( 170 )
|
|
#define DPERR_NOMEMORY E_OUTOFMEMORY
|
|
#define DPERR_OUTOFMEMORY DPERR_NOMEMORY
|
|
#define DPERR_NOMESSAGES MAKE_DPHRESULT( 190 )
|
|
#define DPERR_NONAMESERVERFOUND MAKE_DPHRESULT( 200 )
|
|
#define DPERR_NOPLAYERS MAKE_DPHRESULT( 210 )
|
|
#define DPERR_NOSESSIONS MAKE_DPHRESULT( 220 )
|
|
#define DPERR_SENDTOOBIG MAKE_DPHRESULT( 230 )
|
|
#define DPERR_TIMEOUT MAKE_DPHRESULT( 240 )
|
|
#define DPERR_UNAVAILABLE MAKE_DPHRESULT( 250 )
|
|
#define DPERR_UNSUPPORTED E_NOTIMPL
|
|
#define DPERR_BUSY MAKE_DPHRESULT( 270 )
|
|
#define DPERR_USERCANCEL MAKE_DPHRESULT( 280 )
|
|
|
|
|
|
#define DPOPEN_OPENSESSION 0x00000001
|
|
#define DPOPEN_CREATESESSION 0x00000002
|
|
|
|
#define DPSEND_GUARANTEE 0x00000001
|
|
#define DPSEND_HIGHPRIORITY 0x00000002
|
|
#define DPSEND_TRYONCE 0x00000004
|
|
|
|
#define DPRECEIVE_ALL 0x00000001
|
|
#define DPRECEIVE_TOPLAYER 0x00000002
|
|
#define DPRECEIVE_FROMPLAYER 0x00000004
|
|
#define DPRECEIVE_PEEK 0x00000008
|
|
|
|
#define DPCAPS_NAMESERVICE 0x00000001 // A name server is supported.
|
|
#define DPCAPS_NAMESERVER 0x00000002 // You are the name server.
|
|
#define DPCAPS_GUARANTEED 0x00000004 // SP's don't have to implement guarantees.
|
|
|
|
#define DPENUMSESSIONS_AVAILABLE 0x00000001 // All games that match password (if given)
|
|
// and have openings.
|
|
#define DPENUMSESSIONS_ALL 0x00000002
|
|
#define DPENUMSESSIONS_PREVIOUS 0x00000004
|
|
|
|
#define DPENUMPLAYERS_ALL 0x00000000
|
|
#define DPENUMPLAYERS_PREVIOUS 0x00000004
|
|
#define DPENUMPLAYERS_LOCAL 0x00000008
|
|
#define DPENUMPLAYERS_REMOTE 0x00000010
|
|
#define DPENUMPLAYERS_GROUP 0x00000020
|
|
#define DPENUMPLAYERS_SESSION 0x00000080
|
|
|
|
//
|
|
// This flag is set on the enumsessions callback when the time out has occured.
|
|
// This means that there is no session data for this callback.
|
|
// If lpdwTimeOut is set to a non-zero value and the EnumSessionsCallback returns
|
|
// TRUE then EnumSessions will continue until the next timeout occurs.
|
|
// Timeouts are in milliseconds.
|
|
|
|
#define DPESC_TIMEDOUT 0x00000001
|
|
|
|
|
|
//
|
|
// System message structures and types.
|
|
//
|
|
// System messages have a leading 4 byte type code to identify the message.
|
|
// an app knows it is a system message because it is addressed 'To' player 0.
|
|
//
|
|
|
|
|
|
#define DPSYS_ADDPLAYER 0x0003 // DPMSG_ADDPLAYER
|
|
#define DPSYS_DELETEPLAYER 0x0005 // DPMSG_DELETEPLAYER
|
|
|
|
#define DPSYS_ADDPLAYERTOGROUP 0x0007 // DPMSG_GROUPADD
|
|
|
|
#define DPSYS_INVITE 0x000e // DPMSG_INVITE, Net only.
|
|
|
|
#define DPSYS_DELETEGROUP 0x0020 // DPMSG_DELETEPLAYER
|
|
#define DPSYS_DELETEPLAYERFROMGRP 0x0021 // DPMSG_GROUPDELETE
|
|
#define DPSYS_SESSIONLOST 0x0031
|
|
|
|
#define DPSYS_CONNECT 0x484b // DPMSG_GENERIC
|
|
|
|
|
|
|
|
typedef struct
|
|
{
|
|
DWORD dwType;
|
|
DWORD dwPlayerType;
|
|
DPID dpId;
|
|
char szLongName[DPLONGNAMELEN];
|
|
char szShortName[DPSHORTNAMELEN];
|
|
DWORD dwCurrentPlayers;
|
|
} DPMSG_ADDPLAYER;
|
|
|
|
typedef DPMSG_ADDPLAYER DPMSG_ADDGROUP;
|
|
|
|
typedef struct
|
|
{
|
|
DWORD dwType;
|
|
DPID dpIdGroup;
|
|
DPID dpIdPlayer;
|
|
} DPMSG_GROUPADD;
|
|
|
|
typedef DPMSG_GROUPADD DPMSG_GROUPDELETE;
|
|
typedef struct
|
|
{
|
|
DWORD dwType;
|
|
DPID dpId;
|
|
} DPMSG_DELETEPLAYER;
|
|
|
|
typedef struct
|
|
{
|
|
DWORD dwType;
|
|
DPSESSIONDESC dpsDesc;
|
|
} DPMSG_INVITE;
|
|
|
|
|
|
|
|
typedef struct
|
|
{
|
|
DWORD dwType;
|
|
} DPMSG_GENERIC;
|
|
|
|
#pragma pack(pop)
|
|
|
|
|
|
DEFINE_GUID( IID_IDirectPlay, 0x5454e9a0, 0xdb65, 0x11ce, 0x92, 0x1c, 0x00, 0xaa, 0x00, 0x6c, 0x49, 0x72);
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
};
|
|
#endif
|
|
|
|
#endif
|