summaryrefslogtreecommitdiffstats
path: root/sdk/dx8sdk/Include/dplobby.h
diff options
context:
space:
mode:
Diffstat (limited to 'sdk/dx8sdk/Include/dplobby.h')
-rw-r--r--sdk/dx8sdk/Include/dplobby.h853
1 files changed, 853 insertions, 0 deletions
diff --git a/sdk/dx8sdk/Include/dplobby.h b/sdk/dx8sdk/Include/dplobby.h
new file mode 100644
index 00000000..c91d3238
--- /dev/null
+++ b/sdk/dx8sdk/Include/dplobby.h
@@ -0,0 +1,853 @@
+/*==========================================================================;
+ *
+ * Copyright (C) 1996-1997 Microsoft Corporation. All Rights Reserved.
+ *
+ * File: dplobby.h
+ * Content: DirectPlayLobby include file
+ ***************************************************************************/
+#ifndef __DPLOBBY_INCLUDED__
+#define __DPLOBBY_INCLUDED__
+
+#include "dplay.h"
+
+/* avoid warnings at Level 4 */
+#pragma warning(disable:4201)
+
+#ifdef __cplusplus
+extern "C" {
+#endif /* __cplusplus */
+
+/*
+ * GUIDS used by DirectPlay objects
+ */
+
+/* {AF465C71-9588-11cf-A020-00AA006157AC} */
+DEFINE_GUID(IID_IDirectPlayLobby, 0xaf465c71, 0x9588, 0x11cf, 0xa0, 0x20, 0x0, 0xaa, 0x0, 0x61, 0x57, 0xac);
+/* {26C66A70-B367-11cf-A024-00AA006157AC} */
+DEFINE_GUID(IID_IDirectPlayLobbyA, 0x26c66a70, 0xb367, 0x11cf, 0xa0, 0x24, 0x0, 0xaa, 0x0, 0x61, 0x57, 0xac);
+/* {0194C220-A303-11d0-9C4F-00A0C905425E} */
+DEFINE_GUID(IID_IDirectPlayLobby2, 0x194c220, 0xa303, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
+/* {1BB4AF80-A303-11d0-9C4F-00A0C905425E} */
+DEFINE_GUID(IID_IDirectPlayLobby2A, 0x1bb4af80, 0xa303, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
+/* {2DB72490-652C-11d1-A7A8-0000F803ABFC} */
+DEFINE_GUID(IID_IDirectPlayLobby3, 0x2db72490, 0x652c, 0x11d1, 0xa7, 0xa8, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
+/* {2DB72491-652C-11d1-A7A8-0000F803ABFC} */
+DEFINE_GUID(IID_IDirectPlayLobby3A, 0x2db72491, 0x652c, 0x11d1, 0xa7, 0xa8, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
+/* {2FE8F810-B2A5-11d0-A787-0000F803ABFC} */
+DEFINE_GUID(CLSID_DirectPlayLobby, 0x2fe8f810, 0xb2a5, 0x11d0, 0xa7, 0x87, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
+
+
+/****************************************************************************
+ *
+ * IDirectPlayLobby Structures
+ *
+ * Various structures used to invoke DirectPlayLobby.
+ *
+ ****************************************************************************/
+
+typedef struct IDirectPlayLobby FAR *LPDIRECTPLAYLOBBY;
+typedef struct IDirectPlayLobby FAR *LPDIRECTPLAYLOBBYA;
+typedef struct IDirectPlayLobby IDirectPlayLobbyA;
+
+typedef struct IDirectPlayLobby2 FAR *LPDIRECTPLAYLOBBY2;
+typedef struct IDirectPlayLobby2 FAR *LPDIRECTPLAYLOBBY2A;
+typedef struct IDirectPlayLobby2 IDirectPlayLobby2A;
+
+typedef struct IDirectPlayLobby3 FAR *LPDIRECTPLAYLOBBY3;
+typedef struct IDirectPlayLobby3 FAR *LPDIRECTPLAYLOBBY3A;
+typedef struct IDirectPlayLobby3 IDirectPlayLobby3A;
+
+
+/*
+ * DPLAPPINFO
+ * Used to hold information about a registered DirectPlay
+ * application
+ */
+typedef struct DPLAPPINFO
+{
+ DWORD dwSize; // Size of this structure
+ GUID guidApplication; // GUID of the Application
+ union
+ {
+ LPSTR lpszAppNameA; // Pointer to the Application Name
+ LPWSTR lpszAppName;
+ };
+
+} DPLAPPINFO, FAR *LPDPLAPPINFO;
+
+/*
+ * LPCDPLAPPINFO
+ * A constant pointer to DPLAPPINFO
+ */
+typedef const DPLAPPINFO FAR *LPCDPLAPPINFO;
+
+/*
+ * DPCOMPOUNDADDRESSELEMENT
+ *
+ * An array of these is passed to CreateCompoundAddresses()
+ */
+typedef struct DPCOMPOUNDADDRESSELEMENT
+{
+ GUID guidDataType;
+ DWORD dwDataSize;
+ LPVOID lpData;
+} DPCOMPOUNDADDRESSELEMENT, FAR *LPDPCOMPOUNDADDRESSELEMENT;
+
+/*
+ * LPCDPCOMPOUNDADDRESSELEMENT
+ * A constant pointer to DPCOMPOUNDADDRESSELEMENT
+ */
+typedef const DPCOMPOUNDADDRESSELEMENT FAR *LPCDPCOMPOUNDADDRESSELEMENT;
+
+/*
+ * LPDPAPPLICATIONDESC
+ * Used to register a DirectPlay application
+ */
+typedef struct DPAPPLICATIONDESC
+{
+ DWORD dwSize;
+ DWORD dwFlags;
+ union
+ {
+ LPSTR lpszApplicationNameA;
+ LPWSTR lpszApplicationName;
+ };
+ GUID guidApplication;
+ union
+ {
+ LPSTR lpszFilenameA;
+ LPWSTR lpszFilename;
+ };
+ union
+ {
+ LPSTR lpszCommandLineA;
+ LPWSTR lpszCommandLine;
+ };
+ union
+ {
+ LPSTR lpszPathA;
+ LPWSTR lpszPath;
+ };
+ union
+ {
+ LPSTR lpszCurrentDirectoryA;
+ LPWSTR lpszCurrentDirectory;
+ };
+ LPSTR lpszDescriptionA;
+ LPWSTR lpszDescriptionW;
+} DPAPPLICATIONDESC, *LPDPAPPLICATIONDESC;
+
+/*
+ * LPDPAPPLICATIONDESC2
+ * Used to register a DirectPlay application
+ */
+typedef struct DPAPPLICATIONDESC2
+{
+ DWORD dwSize;
+ DWORD dwFlags;
+ union
+ {
+ LPSTR lpszApplicationNameA;
+ LPWSTR lpszApplicationName;
+ };
+ GUID guidApplication;
+ union
+ {
+ LPSTR lpszFilenameA;
+ LPWSTR lpszFilename;
+ };
+ union
+ {
+ LPSTR lpszCommandLineA;
+ LPWSTR lpszCommandLine;
+ };
+ union
+ {
+ LPSTR lpszPathA;
+ LPWSTR lpszPath;
+ };
+ union
+ {
+ LPSTR lpszCurrentDirectoryA;
+ LPWSTR lpszCurrentDirectory;
+ };
+ LPSTR lpszDescriptionA;
+ LPWSTR lpszDescriptionW;
+ union
+ {
+ LPSTR lpszAppLauncherNameA;
+ LPWSTR lpszAppLauncherName;
+ };
+} DPAPPLICATIONDESC2, *LPDPAPPLICATIONDESC2;
+
+
+/****************************************************************************
+ *
+ * Enumeration Method Callback Prototypes
+ *
+ ****************************************************************************/
+
+/*
+ * Callback for EnumAddress()
+ */
+typedef BOOL (FAR PASCAL *LPDPENUMADDRESSCALLBACK)(
+ REFGUID guidDataType,
+ DWORD dwDataSize,
+ LPCVOID lpData,
+ LPVOID lpContext);
+
+/*
+ * Callback for EnumAddressTypes()
+ */
+typedef BOOL (FAR PASCAL *LPDPLENUMADDRESSTYPESCALLBACK)(
+ REFGUID guidDataType,
+ LPVOID lpContext,
+ DWORD dwFlags);
+
+/*
+ * Callback for EnumLocalApplications()
+ */
+typedef BOOL (FAR PASCAL * LPDPLENUMLOCALAPPLICATIONSCALLBACK)(
+ LPCDPLAPPINFO lpAppInfo,
+ LPVOID lpContext,
+ DWORD dwFlags);
+
+
+/****************************************************************************
+ *
+ * DirectPlayLobby API Prototypes
+ *
+ ****************************************************************************/
+#ifdef UNICODE
+#define DirectPlayLobbyCreate DirectPlayLobbyCreateW
+#else
+#define DirectPlayLobbyCreate DirectPlayLobbyCreateA
+#endif /* UNICODE */
+
+extern HRESULT WINAPI DirectPlayLobbyCreateW(LPGUID, LPDIRECTPLAYLOBBY *, IUnknown *, LPVOID, DWORD );
+extern HRESULT WINAPI DirectPlayLobbyCreateA(LPGUID, LPDIRECTPLAYLOBBYA *, IUnknown *, LPVOID, DWORD );
+
+
+/****************************************************************************
+ *
+ * IDirectPlayLobby (and IDirectPlayLobbyA) Interface
+ *
+ ****************************************************************************/
+#undef INTERFACE
+#define INTERFACE IDirectPlayLobby
+DECLARE_INTERFACE_( IDirectPlayLobby, IUnknown )
+{
+ /* IUnknown Methods */
+ STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
+ STDMETHOD_(ULONG,AddRef) (THIS) PURE;
+ STDMETHOD_(ULONG,Release) (THIS) PURE;
+
+ /* IDirectPlayLobby Methods */
+ STDMETHOD(Connect) (THIS_ DWORD, LPDIRECTPLAY2 *, IUnknown FAR *) PURE;
+ STDMETHOD(CreateAddress) (THIS_ REFGUID, REFGUID, LPCVOID, DWORD, LPVOID, LPDWORD) PURE;
+ STDMETHOD(EnumAddress) (THIS_ LPDPENUMADDRESSCALLBACK, LPCVOID, DWORD, LPVOID) PURE;
+ STDMETHOD(EnumAddressTypes) (THIS_ LPDPLENUMADDRESSTYPESCALLBACK, REFGUID, LPVOID, DWORD) PURE;
+ STDMETHOD(EnumLocalApplications)(THIS_ LPDPLENUMLOCALAPPLICATIONSCALLBACK, LPVOID, DWORD) PURE;
+ STDMETHOD(GetConnectionSettings)(THIS_ DWORD, LPVOID, LPDWORD) PURE;
+ STDMETHOD(ReceiveLobbyMessage) (THIS_ DWORD, DWORD, LPDWORD, LPVOID, LPDWORD) PURE;
+ STDMETHOD(RunApplication) (THIS_ DWORD, LPDWORD, LPDPLCONNECTION, HANDLE) PURE;
+ STDMETHOD(SendLobbyMessage) (THIS_ DWORD, DWORD, LPVOID, DWORD) PURE;
+ STDMETHOD(SetConnectionSettings)(THIS_ DWORD, DWORD, LPDPLCONNECTION) PURE;
+ STDMETHOD(SetLobbyMessageEvent) (THIS_ DWORD, DWORD, HANDLE) PURE;
+
+};
+
+/****************************************************************************
+ *
+ * IDirectPlayLobby2 (and IDirectPlayLobby2A) Interface
+ *
+ ****************************************************************************/
+#undef INTERFACE
+#define INTERFACE IDirectPlayLobby2
+DECLARE_INTERFACE_( IDirectPlayLobby2, IDirectPlayLobby )
+{
+ /* IUnknown Methods */
+ STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
+ STDMETHOD_(ULONG,AddRef) (THIS) PURE;
+ STDMETHOD_(ULONG,Release) (THIS) PURE;
+
+ /* IDirectPlayLobby Methods */
+ STDMETHOD(Connect) (THIS_ DWORD, LPDIRECTPLAY2 *, IUnknown FAR *) PURE;
+ STDMETHOD(CreateAddress) (THIS_ REFGUID, REFGUID, LPCVOID, DWORD, LPVOID, LPDWORD) PURE;
+ STDMETHOD(EnumAddress) (THIS_ LPDPENUMADDRESSCALLBACK, LPCVOID, DWORD, LPVOID) PURE;
+ STDMETHOD(EnumAddressTypes) (THIS_ LPDPLENUMADDRESSTYPESCALLBACK, REFGUID, LPVOID, DWORD) PURE;
+ STDMETHOD(EnumLocalApplications)(THIS_ LPDPLENUMLOCALAPPLICATIONSCALLBACK, LPVOID, DWORD) PURE;
+ STDMETHOD(GetConnectionSettings)(THIS_ DWORD, LPVOID, LPDWORD) PURE;
+ STDMETHOD(ReceiveLobbyMessage) (THIS_ DWORD, DWORD, LPDWORD, LPVOID, LPDWORD) PURE;
+ STDMETHOD(RunApplication) (THIS_ DWORD, LPDWORD, LPDPLCONNECTION, HANDLE) PURE;
+ STDMETHOD(SendLobbyMessage) (THIS_ DWORD, DWORD, LPVOID, DWORD) PURE;
+ STDMETHOD(SetConnectionSettings)(THIS_ DWORD, DWORD, LPDPLCONNECTION) PURE;
+ STDMETHOD(SetLobbyMessageEvent) (THIS_ DWORD, DWORD, HANDLE) PURE;
+
+ /* IDirectPlayLobby2 Methods */
+ STDMETHOD(CreateCompoundAddress)(THIS_ LPCDPCOMPOUNDADDRESSELEMENT,DWORD,LPVOID,LPDWORD) PURE;
+};
+
+/****************************************************************************
+ *
+ * IDirectPlayLobby3 (and IDirectPlayLobby3A) Interface
+ *
+ ****************************************************************************/
+#undef INTERFACE
+#define INTERFACE IDirectPlayLobby3
+DECLARE_INTERFACE_( IDirectPlayLobby3, IDirectPlayLobby )
+{
+ /* IUnknown Methods */
+ STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
+ STDMETHOD_(ULONG,AddRef) (THIS) PURE;
+ STDMETHOD_(ULONG,Release) (THIS) PURE;
+
+ /* IDirectPlayLobby Methods */
+ STDMETHOD(Connect) (THIS_ DWORD, LPDIRECTPLAY2 *, IUnknown FAR *) PURE;
+ STDMETHOD(CreateAddress) (THIS_ REFGUID, REFGUID, LPCVOID, DWORD, LPVOID, LPDWORD) PURE;
+ STDMETHOD(EnumAddress) (THIS_ LPDPENUMADDRESSCALLBACK, LPCVOID, DWORD, LPVOID) PURE;
+ STDMETHOD(EnumAddressTypes) (THIS_ LPDPLENUMADDRESSTYPESCALLBACK, REFGUID, LPVOID, DWORD) PURE;
+ STDMETHOD(EnumLocalApplications)(THIS_ LPDPLENUMLOCALAPPLICATIONSCALLBACK, LPVOID, DWORD) PURE;
+ STDMETHOD(GetConnectionSettings)(THIS_ DWORD, LPVOID, LPDWORD) PURE;
+ STDMETHOD(ReceiveLobbyMessage) (THIS_ DWORD, DWORD, LPDWORD, LPVOID, LPDWORD) PURE;
+ STDMETHOD(RunApplication) (THIS_ DWORD, LPDWORD, LPDPLCONNECTION, HANDLE) PURE;
+ STDMETHOD(SendLobbyMessage) (THIS_ DWORD, DWORD, LPVOID, DWORD) PURE;
+ STDMETHOD(SetConnectionSettings)(THIS_ DWORD, DWORD, LPDPLCONNECTION) PURE;
+ STDMETHOD(SetLobbyMessageEvent) (THIS_ DWORD, DWORD, HANDLE) PURE;
+
+ /* IDirectPlayLobby2 Methods */
+ STDMETHOD(CreateCompoundAddress)(THIS_ LPCDPCOMPOUNDADDRESSELEMENT,DWORD,LPVOID,LPDWORD) PURE;
+
+ /* IDirectPlayLobby3 Methods */
+ STDMETHOD(ConnectEx) (THIS_ DWORD, REFIID, LPVOID *, IUnknown FAR *) PURE;
+ STDMETHOD(RegisterApplication) (THIS_ DWORD, LPVOID) PURE;
+ STDMETHOD(UnregisterApplication)(THIS_ DWORD, REFGUID) PURE;
+ STDMETHOD(WaitForConnectionSettings)(THIS_ DWORD) PURE;
+};
+
+/****************************************************************************
+ *
+ * IDirectPlayLobby interface macros
+ *
+ ****************************************************************************/
+
+#if !defined(__cplusplus) || defined(CINTERFACE)
+
+#define IDirectPlayLobby_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
+#define IDirectPlayLobby_AddRef(p) (p)->lpVtbl->AddRef(p)
+#define IDirectPlayLobby_Release(p) (p)->lpVtbl->Release(p)
+#define IDirectPlayLobby_Connect(p,a,b,c) (p)->lpVtbl->Connect(p,a,b,c)
+#define IDirectPlayLobby_ConnectEx(p,a,b,c,d) (p)->lpVtbl->ConnectEx(p,a,b,c,d)
+#define IDirectPlayLobby_CreateAddress(p,a,b,c,d,e,f) (p)->lpVtbl->CreateAddress(p,a,b,c,d,e,f)
+#define IDirectPlayLobby_CreateCompoundAddress(p,a,b,c,d) (p)->lpVtbl->CreateCompoundAddress(p,a,b,c,d)
+#define IDirectPlayLobby_EnumAddress(p,a,b,c,d) (p)->lpVtbl->EnumAddress(p,a,b,c,d)
+#define IDirectPlayLobby_EnumAddressTypes(p,a,b,c,d) (p)->lpVtbl->EnumAddressTypes(p,a,b,c,d)
+#define IDirectPlayLobby_EnumLocalApplications(p,a,b,c) (p)->lpVtbl->EnumLocalApplications(p,a,b,c)
+#define IDirectPlayLobby_GetConnectionSettings(p,a,b,c) (p)->lpVtbl->GetConnectionSettings(p,a,b,c)
+#define IDirectPlayLobby_ReceiveLobbyMessage(p,a,b,c,d,e) (p)->lpVtbl->ReceiveLobbyMessage(p,a,b,c,d,e)
+#define IDirectPlayLobby_RegisterApplication(p,a,b) (p)->lpVtbl->RegisterApplication(p,a,b)
+#define IDirectPlayLobby_RunApplication(p,a,b,c,d) (p)->lpVtbl->RunApplication(p,a,b,c,d)
+#define IDirectPlayLobby_SendLobbyMessage(p,a,b,c,d) (p)->lpVtbl->SendLobbyMessage(p,a,b,c,d)
+#define IDirectPlayLobby_SetConnectionSettings(p,a,b,c) (p)->lpVtbl->SetConnectionSettings(p,a,b,c)
+#define IDirectPlayLobby_SetLobbyMessageEvent(p,a,b,c) (p)->lpVtbl->SetLobbyMessageEvent(p,a,b,c)
+#define IDirectPlayLobby_UnregisterApplication(p,a,b) (p)->lpVtbl->UnregisterApplication(p,a,b)
+#define IDirectPlayLobby_WaitForConnectionSettings(p,a) (p)->lpVtbl->WaitForConnectionSettings(p,a)
+
+#else /* C++ */
+
+#define IDirectPlayLobby_QueryInterface(p,a,b) (p)->QueryInterface(a,b)
+#define IDirectPlayLobby_AddRef(p) (p)->AddRef()
+#define IDirectPlayLobby_Release(p) (p)->Release()
+#define IDirectPlayLobby_Connect(p,a,b,c) (p)->Connect(a,b,c)
+#define IDirectPlayLobby_ConnectEx(p,a,b,c,d) (p)->ConnectEx(a,b,c,d)
+#define IDirectPlayLobby_CreateAddress(p,a,b,c,d,e,f) (p)->CreateAddress(a,b,c,d,e,f)
+#define IDirectPlayLobby_CreateCompoundAddress(p,a,b,c,d) (p)->CreateCompoundAddress(a,b,c,d)
+#define IDirectPlayLobby_EnumAddress(p,a,b,c,d) (p)->EnumAddress(a,b,c,d)
+#define IDirectPlayLobby_EnumAddressTypes(p,a,b,c,d) (p)->EnumAddressTypes(a,b,c,d)
+#define IDirectPlayLobby_EnumLocalApplications(p,a,b,c) (p)->EnumLocalApplications(a,b,c)
+#define IDirectPlayLobby_GetConnectionSettings(p,a,b,c) (p)->GetConnectionSettings(a,b,c)
+#define IDirectPlayLobby_ReceiveLobbyMessage(p,a,b,c,d,e) (p)->ReceiveLobbyMessage(a,b,c,d,e)
+#define IDirectPlayLobby_RegisterApplication(p,a,b) (p)->RegisterApplication(a,b)
+#define IDirectPlayLobby_RunApplication(p,a,b,c,d) (p)->RunApplication(a,b,c,d)
+#define IDirectPlayLobby_SendLobbyMessage(p,a,b,c,d) (p)->SendLobbyMessage(a,b,c,d)
+#define IDirectPlayLobby_SetConnectionSettings(p,a,b,c) (p)->SetConnectionSettings(a,b,c)
+#define IDirectPlayLobby_SetLobbyMessageEvent(p,a,b,c) (p)->SetLobbyMessageEvent(a,b,c)
+#define IDirectPlayLobby_UnregisterApplication(p,a,b) (p)->UnregisterApplication(a,b)
+#define IDirectPlayLobby_WaitForConnectionSettings(p,a) (p)->WaitForConnectionSettings(a)
+
+#endif
+
+/****************************************************************************
+ *
+ * DirectPlayLobby Flags
+ *
+ ****************************************************************************/
+
+/*
+ * This flag is used by IDirectPlayLobby->WaitForConnectionSettings to
+ * cancel a current wait that is in progress.
+ */
+#define DPLWAIT_CANCEL 0x00000001
+
+
+/*
+ * This is a message flag used by ReceiveLobbyMessage. It can be
+ * returned in the dwMessageFlags parameter to indicate a message from
+ * the system.
+ */
+#define DPLMSG_SYSTEM 0x00000001
+
+/*
+ * This is a message flag used by ReceiveLobbyMessage and SendLobbyMessage.
+ * It is used to indicate that the message is a standard lobby message.
+ * DPLMSG_SETPROPERTY, DPLMSG_SETPROPERTYRESPONSE, DPLMSG_GETPROPERTY,
+ * DPLMSG_GETPROPERTYRESPONSE
+ */
+#define DPLMSG_STANDARD 0x00000002
+
+/*
+ * Lobbyable Application registration flags
+ */
+
+/*
+ * Applications registered with this flag will not show up when
+ * applications are enumerated in the lobby. This application
+ * will only be able to be launched by a lobby client that already
+ * knows about the application.
+ */
+#define DPLAPP_NOENUM 0x80000000
+
+/*
+ * Applications registered with this flag want voice to automatically
+ * be enabled for their application. All players will be launched into
+ * an 'n'-way voice conference when the application is started. The
+ * user will be able to enable this flag for existing non-voice
+ * directplay applications.
+ */
+#define DPLAPP_AUTOVOICE 0x00000001
+
+/*
+ * Applications that do their own voice conferencing should register with
+ * this flag to avoid allowing the user to enable other voice chat
+ * capabilites during the same session. This is to avoid users forcing
+ * the DPLAPP_AUTOVOICE flag for the application.
+ */
+#define DPLAPP_SELFVOICE 0x00000002
+
+/****************************************************************************
+ *
+ * DirectPlayLobby messages and message data structures
+ *
+ * All system messages have a dwMessageFlags value of DPLMSG_SYSTEM returned
+ * from a call to ReceiveLobbyMessage.
+ *
+ * All standard messages have a dwMessageFlags value of DPLMSG_STANDARD returned
+ * from a call to ReceiveLobbyMessage.
+ *
+ ****************************************************************************/
+
+/*
+ * DPLMSG_GENERIC
+ * Generic message structure used to identify the message type.
+ */
+typedef struct _DPLMSG_GENERIC
+{
+ DWORD dwType; // Message type
+} DPLMSG_GENERIC, FAR *LPDPLMSG_GENERIC;
+
+/*
+ * DPLMSG_SYSTEMMESSAGE
+ * Generic message format for all system messages --
+ * DPLSYS_CONNECTIONSETTINGSREAD, DPLSYS_DPLYCONNECTSUCCEEDED,
+ * DPLSYS_DPLAYCONNECTFAILED, DPLSYS_APPTERMINATED, DPLSYS_NEWCONNECTIONSETTINGS
+ */
+typedef struct _DPLMSG_SYSTEMMESSAGE
+{
+ DWORD dwType; // Message type
+ GUID guidInstance; // Instance GUID of the dplay session the message corresponds to
+} DPLMSG_SYSTEMMESSAGE, FAR *LPDPLMSG_SYSTEMMESSAGE;
+
+/*
+ * DPLMSG_SETPROPERTY
+ * Standard message sent by an application to a lobby to set a
+ * property
+ */
+typedef struct _DPLMSG_SETPROPERTY
+{
+ DWORD dwType; // Message type
+ DWORD dwRequestID; // Request ID (DPL_NOCONFIRMATION if no confirmation desired)
+ GUID guidPlayer; // Player GUID
+ GUID guidPropertyTag; // Property GUID
+ DWORD dwDataSize; // Size of data
+ DWORD dwPropertyData[1]; // Buffer containing data
+} DPLMSG_SETPROPERTY, FAR *LPDPLMSG_SETPROPERTY;
+
+#define DPL_NOCONFIRMATION 0
+
+/*
+ * DPLMSG_SETPROPERTYRESPONSE
+ * Standard message returned by a lobby to confirm a
+ * DPLMSG_SETPROPERTY message.
+ */
+typedef struct _DPLMSG_SETPROPERTYRESPONSE
+{
+ DWORD dwType; // Message type
+ DWORD dwRequestID; // Request ID
+ GUID guidPlayer; // Player GUID
+ GUID guidPropertyTag; // Property GUID
+ HRESULT hr; // Return Code
+} DPLMSG_SETPROPERTYRESPONSE, FAR *LPDPLMSG_SETPROPERTYRESPONSE;
+
+/*
+ * DPLMSG_GETPROPERTY
+ * Standard message sent by an application to a lobby to request
+ * the current value of a property
+ */
+typedef struct _DPLMSG_GETPROPERTY
+{
+ DWORD dwType; // Message type
+ DWORD dwRequestID; // Request ID
+ GUID guidPlayer; // Player GUID
+ GUID guidPropertyTag; // Property GUID
+} DPLMSG_GETPROPERTY, FAR *LPDPLMSG_GETPROPERTY;
+
+/*
+ * DPLMSG_GETPROPERTYRESPONSE
+ * Standard message returned by a lobby in response to a
+ * DPLMSG_GETPROPERTY message.
+ */
+typedef struct _DPLMSG_GETPROPERTYRESPONSE
+{
+ DWORD dwType; // Message type
+ DWORD dwRequestID; // Request ID
+ GUID guidPlayer; // Player GUID
+ GUID guidPropertyTag; // Property GUID
+ HRESULT hr; // Return Code
+ DWORD dwDataSize; // Size of data
+ DWORD dwPropertyData[1]; // Buffer containing data
+} DPLMSG_GETPROPERTYRESPONSE, FAR *LPDPLMSG_GETPROPERTYRESPONSE;
+
+/*
+ * DPLMSG_NEWSESSIONHOST
+ * Standard message returned by a lobby in response to a
+ * the session host migrating to a new client
+ */
+typedef struct _DPLMSG_NEWSESSIONHOST
+{
+ DWORD dwType; // Message type
+ GUID guidInstance; // GUID Instance of the session
+} DPLMSG_NEWSESSIONHOST, FAR *LPDPLMSG_NEWSESSIONHOST;
+
+
+/******************************************
+ *
+ * DirectPlay Lobby message dwType values
+ *
+ *****************************************/
+
+/*
+ * The application has read the connection settings.
+ * It is now O.K. for the lobby client to release
+ * its IDirectPlayLobby interface.
+ */
+#define DPLSYS_CONNECTIONSETTINGSREAD 0x00000001
+
+/*
+ * The application's call to DirectPlayConnect failed
+ */
+#define DPLSYS_DPLAYCONNECTFAILED 0x00000002
+
+/*
+ * The application has created a DirectPlay session.
+ */
+#define DPLSYS_DPLAYCONNECTSUCCEEDED 0x00000003
+
+/*
+ * The application has terminated.
+ */
+#define DPLSYS_APPTERMINATED 0x00000004
+
+/*
+ * The message is a DPLMSG_SETPROPERTY message.
+ */
+#define DPLSYS_SETPROPERTY 0x00000005
+
+/*
+ * The message is a DPLMSG_SETPROPERTYRESPONSE message.
+ */
+#define DPLSYS_SETPROPERTYRESPONSE 0x00000006
+
+/*
+ * The message is a DPLMSG_GETPROPERTY message.
+ */
+#define DPLSYS_GETPROPERTY 0x00000007
+
+/*
+ * The message is a DPLMSG_GETPROPERTYRESPONSE message.
+ */
+#define DPLSYS_GETPROPERTYRESPONSE 0x00000008
+
+/*
+ * The message is a DPLMSG_NEWSESSIONHOST message.
+ */
+#define DPLSYS_NEWSESSIONHOST 0x00000009
+
+/*
+ * New connection settings are available.
+ */
+#define DPLSYS_NEWCONNECTIONSETTINGS 0x0000000A
+
+/*
+ * The Lobby Client has released the DirectPlayLobby Interface
+ */
+#define DPLSYS_LOBBYCLIENTRELEASE 0x0000000B
+
+/****************************************************************************
+ *
+ * DirectPlay defined property GUIDs and associated data structures
+ *
+ ****************************************************************************/
+
+/*
+ * DPLPROPERTY_MessagesSupported
+ *
+ * Request whether the lobby supports standard. Lobby with respond with either
+ * TRUE or FALSE or may not respond at all.
+ *
+ * Property data is a single BOOL with TRUE or FALSE
+ */
+// {762CCDA1-D916-11d0-BA39-00C04FD7ED67}
+DEFINE_GUID(DPLPROPERTY_MessagesSupported,
+0x762ccda1, 0xd916, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
+
+/*
+ * DPLPROPERTY_LobbyGuid
+ *
+ * Request the GUID that identifies the lobby software that the application
+ * is communicating with.
+ *
+ * Property data is a single GUID.
+ */
+// {F56920A0-D218-11d0-BA39-00C04FD7ED67}
+DEFINE_GUID(DPLPROPERTY_LobbyGuid,
+0xf56920a0, 0xd218, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
+
+/*
+ * DPLPROPERTY_PlayerGuid
+ *
+ * Request the GUID that identifies the player on this machine for sending
+ * property data back to the lobby.
+ *
+ * Property data is the DPLDATA_PLAYERDATA structure
+ */
+// {B4319322-D20D-11d0-BA39-00C04FD7ED67}
+DEFINE_GUID(DPLPROPERTY_PlayerGuid,
+0xb4319322, 0xd20d, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
+
+/*
+ * DPLDATA_PLAYERGUID
+ *
+ * Data structure to hold the GUID of the player and player creation flags
+ * from the lobby.
+ */
+typedef struct _DPLDATA_PLAYERGUID
+{
+ GUID guidPlayer;
+ DWORD dwPlayerFlags;
+} DPLDATA_PLAYERGUID, FAR *LPDPLDATA_PLAYERGUID;
+
+/*
+ * DPLPROPERTY_PlayerScore
+ *
+ * Used to send an array of long integers to the lobby indicating the
+ * score of a player.
+ *
+ * Property data is the DPLDATA_PLAYERSCORE structure.
+ */
+// {48784000-D219-11d0-BA39-00C04FD7ED67}
+DEFINE_GUID(DPLPROPERTY_PlayerScore,
+0x48784000, 0xd219, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
+
+/*
+ * DPLDATA_PLAYERSCORE
+ *
+ * Data structure to hold an array of long integers representing a player score.
+ * Application must allocate enough memory to hold all the scores.
+ */
+typedef struct _DPLDATA_PLAYERSCORE
+{
+ DWORD dwScoreCount;
+ LONG Score[1];
+} DPLDATA_PLAYERSCORE, FAR *LPDPLDATA_PLAYERSCORE;
+
+/****************************************************************************
+ *
+ * DirectPlay Address ID's
+ *
+ ****************************************************************************/
+
+/* DirectPlay Address
+ *
+ * A DirectPlay address consists of multiple chunks of data, each tagged
+ * with a GUID signifying the type of data in the chunk. The chunk also
+ * has a length so that unknown chunk types can be skipped.
+ *
+ * The EnumAddress() function is used to parse these address data chunks.
+ */
+
+/*
+ * DPADDRESS
+ *
+ * Header for block of address data elements
+ */
+typedef struct _DPADDRESS
+{
+ GUID guidDataType;
+ DWORD dwDataSize;
+} DPADDRESS;
+
+typedef DPADDRESS FAR *LPDPADDRESS;
+
+/*
+ * DPAID_TotalSize
+ *
+ * Chunk is a DWORD containing size of entire DPADDRESS structure
+ */
+
+// {1318F560-912C-11d0-9DAA-00A0C90A43CB}
+DEFINE_GUID(DPAID_TotalSize,
+0x1318f560, 0x912c, 0x11d0, 0x9d, 0xaa, 0x0, 0xa0, 0xc9, 0xa, 0x43, 0xcb);
+
+/*
+ * DPAID_ServiceProvider
+ *
+ * Chunk is a GUID describing the service provider that created the chunk.
+ * All addresses must contain this chunk.
+ */
+
+// {07D916C0-E0AF-11cf-9C4E-00A0C905425E}
+DEFINE_GUID(DPAID_ServiceProvider,
+0x7d916c0, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
+
+/*
+ * DPAID_LobbyProvider
+ *
+ * Chunk is a GUID describing the lobby provider that created the chunk.
+ * All addresses must contain this chunk.
+ */
+
+// {59B95640-9667-11d0-A77D-0000F803ABFC}
+DEFINE_GUID(DPAID_LobbyProvider,
+0x59b95640, 0x9667, 0x11d0, 0xa7, 0x7d, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
+
+/*
+ * DPAID_Phone and DPAID_PhoneW
+ *
+ * Chunk is a string containing a phone number (i.e. "1-800-555-1212")
+ * in ANSI or UNICODE format
+ */
+
+// {78EC89A0-E0AF-11cf-9C4E-00A0C905425E}
+DEFINE_GUID(DPAID_Phone,
+0x78ec89a0, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
+
+// {BA5A7A70-9DBF-11d0-9CC1-00A0C905425E}
+DEFINE_GUID(DPAID_PhoneW,
+0xba5a7a70, 0x9dbf, 0x11d0, 0x9c, 0xc1, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
+
+/*
+ * DPAID_Modem and DPAID_ModemW
+ *
+ * Chunk is a string containing a modem name registered with TAPI
+ * in ANSI or UNICODE format
+ */
+
+// {F6DCC200-A2FE-11d0-9C4F-00A0C905425E}
+DEFINE_GUID(DPAID_Modem,
+0xf6dcc200, 0xa2fe, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
+
+// {01FD92E0-A2FF-11d0-9C4F-00A0C905425E}
+DEFINE_GUID(DPAID_ModemW,
+0x1fd92e0, 0xa2ff, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
+
+/*
+ * DPAID_Inet and DPAID_InetW
+ *
+ * Chunk is a string containing a TCP/IP host name or an IP address
+ * (i.e. "dplay.microsoft.com" or "137.55.100.173") in ANSI or UNICODE format
+ */
+
+// {C4A54DA0-E0AF-11cf-9C4E-00A0C905425E}
+DEFINE_GUID(DPAID_INet,
+0xc4a54da0, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
+
+// {E63232A0-9DBF-11d0-9CC1-00A0C905425E}
+DEFINE_GUID(DPAID_INetW,
+0xe63232a0, 0x9dbf, 0x11d0, 0x9c, 0xc1, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
+
+/*
+ * DPAID_InetPort
+ *
+ * Chunk is the port number used for creating the apps TCP and UDP sockets.
+ * WORD value (i.e. 47624).
+ */
+
+// {E4524541-8EA5-11d1-8A96-006097B01411}
+DEFINE_GUID(DPAID_INetPort,
+0xe4524541, 0x8ea5, 0x11d1, 0x8a, 0x96, 0x0, 0x60, 0x97, 0xb0, 0x14, 0x11);
+
+#ifdef BIGMESSAGEDEFENSE
+#endif
+
+/*
+ * DPCOMPORTADDRESS
+ *
+ * Used to specify com port settings. The constants that define baud rate,
+ * stop bits and parity are defined in WINBASE.H. The constants for flow
+ * control are given below.
+ */
+
+#define DPCPA_NOFLOW 0 // no flow control
+#define DPCPA_XONXOFFFLOW 1 // software flow control
+#define DPCPA_RTSFLOW 2 // hardware flow control with RTS
+#define DPCPA_DTRFLOW 3 // hardware flow control with DTR
+#define DPCPA_RTSDTRFLOW 4 // hardware flow control with RTS and DTR
+
+typedef struct _DPCOMPORTADDRESS
+{
+ DWORD dwComPort; // COM port to use (1-4)
+ DWORD dwBaudRate; // baud rate (100-256k)
+ DWORD dwStopBits; // no. stop bits (1-2)
+ DWORD dwParity; // parity (none, odd, even, mark)
+ DWORD dwFlowControl; // flow control (none, xon/xoff, rts, dtr)
+} DPCOMPORTADDRESS;
+
+typedef DPCOMPORTADDRESS FAR *LPDPCOMPORTADDRESS;
+
+/*
+ * DPAID_ComPort
+ *
+ * Chunk contains a DPCOMPORTADDRESS structure defining the serial port.
+ */
+
+// {F2F0CE00-E0AF-11cf-9C4E-00A0C905425E}
+DEFINE_GUID(DPAID_ComPort,
+0xf2f0ce00, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
+
+/****************************************************************************
+ *
+ * dplobby 1.0 obsolete definitions
+ * Included for compatibility only.
+ *
+ ****************************************************************************/
+#define DPLAD_SYSTEM DPLMSG_SYSTEM
+
+
+#ifdef __cplusplus
+};
+#endif /* __cplusplus */
+
+#pragma warning(default:4201)
+
+#endif /* __DPLOBBY_INCLUDED__ */
+
generated by cgit v1.2.3 (git 2.25.1) at 2024-11-01 06:13:29 +0100