home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / vc98 / include / dplobby.h < prev    next >
C/C++ Source or Header  |  1998-04-25  |  22KB  |  628 lines
  1. /*==========================================================================;
  2.  *
  3.  *  Copyright (C) 1996-1997 Microsoft Corporation.  All Rights Reserved.
  4.  *
  5.  *  File:       dplobby.h
  6.  *  Content:    DirectPlayLobby include file
  7.  ***************************************************************************/
  8. #ifndef __DPLOBBY_INCLUDED__
  9. #define __DPLOBBY_INCLUDED__
  10.  
  11. #include "dplay.h"
  12.  
  13. #ifdef __cplusplus
  14. extern "C" {
  15. #endif /* __cplusplus */
  16.  
  17. /*
  18.  * GUIDS used by DirectPlay objects
  19.  */
  20.  
  21. /* {AF465C71-9588-11cf-A020-00AA006157AC} */
  22. DEFINE_GUID(IID_IDirectPlayLobby, 0xaf465c71, 0x9588, 0x11cf, 0xa0, 0x20, 0x0, 0xaa, 0x0, 0x61, 0x57, 0xac);
  23. /* {26C66A70-B367-11cf-A024-00AA006157AC} */
  24. DEFINE_GUID(IID_IDirectPlayLobbyA, 0x26c66a70, 0xb367, 0x11cf, 0xa0, 0x24, 0x0, 0xaa, 0x0, 0x61, 0x57, 0xac);
  25. /* {0194C220-A303-11d0-9C4F-00A0C905425E} */
  26. DEFINE_GUID(IID_IDirectPlayLobby2, 0x194c220, 0xa303, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
  27. /* {1BB4AF80-A303-11d0-9C4F-00A0C905425E} */
  28. DEFINE_GUID(IID_IDirectPlayLobby2A, 0x1bb4af80, 0xa303, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
  29. /* {2FE8F810-B2A5-11d0-A787-0000F803ABFC} */
  30. DEFINE_GUID(CLSID_DirectPlayLobby, 0x2fe8f810, 0xb2a5, 0x11d0, 0xa7, 0x87, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
  31.  
  32.  
  33. /****************************************************************************
  34.  *
  35.  * IDirectPlayLobby Structures
  36.  *
  37.  * Various structures used to invoke DirectPlayLobby.
  38.  *
  39.  ****************************************************************************/
  40.  
  41. typedef struct IDirectPlayLobby     FAR *LPDIRECTPLAYLOBBY;
  42. typedef struct IDirectPlayLobby     FAR *LPDIRECTPLAYLOBBYA;
  43. typedef struct IDirectPlayLobby     IDirectPlayLobbyA;
  44.  
  45. typedef struct IDirectPlayLobby2    FAR *LPDIRECTPLAYLOBBY2;
  46. typedef struct IDirectPlayLobby2    FAR *LPDIRECTPLAYLOBBY2A;
  47. typedef struct IDirectPlayLobby2    IDirectPlayLobby2A;
  48.  
  49.  
  50. /*
  51.  * DPLAPPINFO
  52.  * Used to hold information about a registered DirectPlay
  53.  * application
  54.  */
  55. typedef struct DPLAPPINFO
  56. {
  57.     DWORD       dwSize;             // Size of this structure
  58.     GUID        guidApplication;    // GUID of the Application
  59.     union
  60.     {
  61.         LPSTR   lpszAppNameA;       // Pointer to the Application Name
  62.         LPWSTR  lpszAppName;
  63.     };
  64.  
  65. } DPLAPPINFO, FAR *LPDPLAPPINFO;
  66.  
  67. /*
  68.  * LPCDPLAPPINFO
  69.  * A constant pointer to DPLAPPINFO
  70.  */
  71. typedef const DPLAPPINFO FAR *LPCDPLAPPINFO;
  72.  
  73. /*
  74.  * DPCOMPOUNDADDRESSELEMENT
  75.  *
  76.  * An array of these is passed to CreateCompoundAddresses()
  77.  */
  78. typedef struct DPCOMPOUNDADDRESSELEMENT
  79. {
  80.     GUID                guidDataType;
  81.     DWORD               dwDataSize;
  82.     LPVOID                lpData;
  83. } DPCOMPOUNDADDRESSELEMENT, FAR *LPDPCOMPOUNDADDRESSELEMENT;
  84.  
  85. /*
  86.  * LPCDPCOMPOUNDADDRESSELEMENT
  87.  * A constant pointer to DPCOMPOUNDADDRESSELEMENT
  88.  */
  89. typedef const DPCOMPOUNDADDRESSELEMENT FAR *LPCDPCOMPOUNDADDRESSELEMENT;
  90.  
  91.  
  92. /****************************************************************************
  93.  *
  94.  * Enumeration Method Callback Prototypes
  95.  *
  96.  ****************************************************************************/
  97.  
  98. /*
  99.  * Callback for EnumAddress()
  100.  */
  101. typedef BOOL (FAR PASCAL *LPDPENUMADDRESSCALLBACK)(
  102.     REFGUID         guidDataType,
  103.     DWORD           dwDataSize,
  104.     LPCVOID         lpData,
  105.     LPVOID          lpContext);
  106.  
  107. /*
  108.  * Callback for EnumAddressTypes()
  109.  */
  110. typedef BOOL (FAR PASCAL *LPDPLENUMADDRESSTYPESCALLBACK)(
  111.     REFGUID         guidDataType,
  112.     LPVOID          lpContext,
  113.     DWORD           dwFlags);
  114.  
  115. /*
  116.  * Callback for EnumLocalApplications()
  117.  */
  118. typedef BOOL (FAR PASCAL * LPDPLENUMLOCALAPPLICATIONSCALLBACK)(
  119.     LPCDPLAPPINFO   lpAppInfo,
  120.     LPVOID          lpContext,
  121.     DWORD           dwFlags);
  122.  
  123.  
  124. /****************************************************************************
  125.  *
  126.  * DirectPlayLobby API Prototypes
  127.  *
  128.  ****************************************************************************/
  129. #ifdef UNICODE
  130. #define DirectPlayLobbyCreate   DirectPlayLobbyCreateW
  131. #else
  132. #define DirectPlayLobbyCreate   DirectPlayLobbyCreateA
  133. #endif /* UNICODE */
  134.  
  135. extern HRESULT WINAPI DirectPlayLobbyCreateW(LPGUID, LPDIRECTPLAYLOBBY *, IUnknown *, LPVOID, DWORD );
  136. extern HRESULT WINAPI DirectPlayLobbyCreateA(LPGUID, LPDIRECTPLAYLOBBYA *, IUnknown *, LPVOID, DWORD );
  137.  
  138.  
  139. /****************************************************************************
  140.  *
  141.  * IDirectPlayLobby (and IDirectPlayLobbyA) Interface
  142.  *
  143.  ****************************************************************************/
  144. #undef INTERFACE
  145. #define INTERFACE IDirectPlayLobby
  146. DECLARE_INTERFACE_( IDirectPlayLobby, IUnknown )
  147. {
  148.     /*  IUnknown Methods    */
  149.     STDMETHOD(QueryInterface)       (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
  150.     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
  151.     STDMETHOD_(ULONG,Release)       (THIS) PURE;
  152.  
  153.     /*  IDirectPlayLobby Methods    */
  154.     STDMETHOD(Connect)              (THIS_ DWORD, LPDIRECTPLAY2 *, IUnknown FAR *) PURE;
  155.     STDMETHOD(CreateAddress)        (THIS_ REFGUID, REFGUID, LPCVOID, DWORD, LPVOID, LPDWORD) PURE;
  156.     STDMETHOD(EnumAddress)          (THIS_ LPDPENUMADDRESSCALLBACK, LPCVOID, DWORD, LPVOID) PURE;
  157.     STDMETHOD(EnumAddressTypes)     (THIS_ LPDPLENUMADDRESSTYPESCALLBACK, REFGUID, LPVOID, DWORD) PURE;
  158.     STDMETHOD(EnumLocalApplications)(THIS_ LPDPLENUMLOCALAPPLICATIONSCALLBACK, LPVOID, DWORD) PURE;
  159.     STDMETHOD(GetConnectionSettings)(THIS_ DWORD, LPVOID, LPDWORD) PURE;
  160.     STDMETHOD(ReceiveLobbyMessage)  (THIS_ DWORD, DWORD, LPDWORD, LPVOID, LPDWORD) PURE;
  161.     STDMETHOD(RunApplication)       (THIS_ DWORD, LPDWORD, LPDPLCONNECTION, HANDLE) PURE;
  162.     STDMETHOD(SendLobbyMessage)     (THIS_ DWORD, DWORD, LPVOID, DWORD) PURE;
  163.     STDMETHOD(SetConnectionSettings)(THIS_ DWORD, DWORD, LPDPLCONNECTION) PURE;
  164.     STDMETHOD(SetLobbyMessageEvent) (THIS_ DWORD, DWORD, HANDLE) PURE;
  165.  
  166. };
  167.  
  168. /****************************************************************************
  169.  *
  170.  * IDirectPlayLobby2 (and IDirectPlayLobby2A) Interface
  171.  *
  172.  ****************************************************************************/
  173. #undef INTERFACE
  174. #define INTERFACE IDirectPlayLobby2
  175. DECLARE_INTERFACE_( IDirectPlayLobby2, IDirectPlayLobby )
  176. {
  177.     /*  IUnknown Methods    */
  178.     STDMETHOD(QueryInterface)       (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
  179.     STDMETHOD_(ULONG,AddRef)        (THIS) PURE;
  180.     STDMETHOD_(ULONG,Release)       (THIS) PURE;
  181.  
  182.     /*  IDirectPlayLobby Methods    */
  183.     STDMETHOD(Connect)              (THIS_ DWORD, LPDIRECTPLAY2 *, IUnknown FAR *) PURE;
  184.     STDMETHOD(CreateAddress)        (THIS_ REFGUID, REFGUID, LPCVOID, DWORD, LPVOID, LPDWORD) PURE;
  185.     STDMETHOD(EnumAddress)          (THIS_ LPDPENUMADDRESSCALLBACK, LPCVOID, DWORD, LPVOID) PURE;
  186.     STDMETHOD(EnumAddressTypes)     (THIS_ LPDPLENUMADDRESSTYPESCALLBACK, REFGUID, LPVOID, DWORD) PURE;
  187.     STDMETHOD(EnumLocalApplications)(THIS_ LPDPLENUMLOCALAPPLICATIONSCALLBACK, LPVOID, DWORD) PURE;
  188.     STDMETHOD(GetConnectionSettings)(THIS_ DWORD, LPVOID, LPDWORD) PURE;
  189.     STDMETHOD(ReceiveLobbyMessage)  (THIS_ DWORD, DWORD, LPDWORD, LPVOID, LPDWORD) PURE;
  190.     STDMETHOD(RunApplication)       (THIS_ DWORD, LPDWORD, LPDPLCONNECTION, HANDLE) PURE;
  191.     STDMETHOD(SendLobbyMessage)     (THIS_ DWORD, DWORD, LPVOID, DWORD) PURE;
  192.     STDMETHOD(SetConnectionSettings)(THIS_ DWORD, DWORD, LPDPLCONNECTION) PURE;
  193.     STDMETHOD(SetLobbyMessageEvent) (THIS_ DWORD, DWORD, HANDLE) PURE;
  194.  
  195.     /*  IDirectPlayLobby2 Methods    */
  196.     STDMETHOD(CreateCompoundAddress)(THIS_ LPCDPCOMPOUNDADDRESSELEMENT,DWORD,LPVOID,LPDWORD) PURE;
  197. };
  198.  
  199. /****************************************************************************
  200.  *
  201.  * IDirectPlayLobby interface macros
  202.  *
  203.  ****************************************************************************/
  204.  
  205. #if !defined(__cplusplus) || defined(CINTERFACE)
  206.  
  207. #define IDirectPlayLobby_QueryInterface(p,a,b)              (p)->lpVtbl->QueryInterface(p,a,b)
  208. #define IDirectPlayLobby_AddRef(p)                          (p)->lpVtbl->AddRef(p)
  209. #define IDirectPlayLobby_Release(p)                         (p)->lpVtbl->Release(p)
  210. #define IDirectPlayLobby_Connect(p,a,b,c)                   (p)->lpVtbl->Connect(p,a,b,c)
  211. #define IDirectPlayLobby_CreateAddress(p,a,b,c,d,e,f)       (p)->lpVtbl->CreateAddress(p,a,b,c,d,e,f)
  212. #define IDirectPlayLobby_CreateCompoundAddress(p,a,b,c,d)   (p)->lpVtbl->CreateCompoundAddress(p,a,b,c,d)
  213. #define IDirectPlayLobby_EnumAddress(p,a,b,c,d)             (p)->lpVtbl->EnumAddress(p,a,b,c,d)
  214. #define IDirectPlayLobby_EnumAddressTypes(p,a,b,c,d)        (p)->lpVtbl->EnumAddressTypes(p,a,b,c,d)
  215. #define IDirectPlayLobby_EnumLocalApplications(p,a,b,c)     (p)->lpVtbl->EnumLocalApplications(p,a,b,c)
  216. #define IDirectPlayLobby_GetConnectionSettings(p,a,b,c)     (p)->lpVtbl->GetConnectionSettings(p,a,b,c)
  217. #define IDirectPlayLobby_ReceiveLobbyMessage(p,a,b,c,d,e)   (p)->lpVtbl->ReceiveLobbyMessage(p,a,b,c,d,e)
  218. #define IDirectPlayLobby_RunApplication(p,a,b,c,d)          (p)->lpVtbl->RunApplication(p,a,b,c,d)
  219. #define IDirectPlayLobby_SendLobbyMessage(p,a,b,c,d)        (p)->lpVtbl->SendLobbyMessage(p,a,b,c,d)
  220. #define IDirectPlayLobby_SetConnectionSettings(p,a,b,c)        (p)->lpVtbl->SetConnectionSettings(p,a,b,c)
  221. #define IDirectPlayLobby_SetLobbyMessageEvent(p,a,b,c)        (p)->lpVtbl->SetLobbyMessageEvent(p,a,b,c)
  222.  
  223. #else /* C++ */
  224.  
  225. #define IDirectPlayLobby_QueryInterface(p,a,b)              (p)->QueryInterface(a,b)
  226. #define IDirectPlayLobby_AddRef(p)                          (p)->AddRef()
  227. #define IDirectPlayLobby_Release(p)                         (p)->Release()
  228. #define IDirectPlayLobby_Connect(p,a,b,c)                   (p)->Connect(a,b,c)
  229. #define IDirectPlayLobby_CreateAddress(p,a,b,c,d,e,f)       (p)->CreateAddress(a,b,c,d,e,f)
  230. #define IDirectPlayLobby_CreateCompoundAddress(p,a,b,c,d)   (p)->lpVtbl->CreateCompoundAddress(a,b,c,d)
  231. #define IDirectPlayLobby_EnumAddress(p,a,b,c,d)             (p)->EnumAddress(a,b,c,d)
  232. #define IDirectPlayLobby_EnumAddressTypes(p,a,b,c,d)        (p)->EnumAddressTypes(a,b,c,d)
  233. #define IDirectPlayLobby_EnumLocalApplications(p,a,b,c)     (p)->EnumLocalApplications(a,b,c)
  234. #define IDirectPlayLobby_GetConnectionSettings(p,a,b,c)     (p)->GetConnectionSettings(a,b,c)
  235. #define IDirectPlayLobby_ReceiveLobbyMessage(p,a,b,c,d,e)   (p)->ReceiveLobbyMessage(a,b,c,d,e)
  236. #define IDirectPlayLobby_RunApplication(p,a,b,c,d)          (p)->RunApplication(a,b,c,d)
  237. #define IDirectPlayLobby_SendLobbyMessage(p,a,b,c,d)        (p)->SendLobbyMessage(a,b,c,d)
  238. #define IDirectPlayLobby_SetConnectionSettings(p,a,b,c)        (p)->SetConnectionSettings(a,b,c)
  239. #define IDirectPlayLobby_SetLobbyMessageEvent(p,a,b,c)        (p)->SetLobbyMessageEvent(a,b,c)
  240.  
  241. #endif
  242.  
  243. /****************************************************************************
  244.  *
  245.  * DirectPlayLobby Flags
  246.  *
  247.  ****************************************************************************/
  248.  
  249. /*
  250.  *    This is a message flag used by ReceiveLobbyMessage.  It can be
  251.  *    returned in the dwMessageFlags parameter to indicate a message from
  252.  *    the system.
  253.  */
  254. #define DPLMSG_SYSTEM                    0x00000001
  255.  
  256. /*
  257.  *    This is a message flag used by ReceiveLobbyMessage and SendLobbyMessage.
  258.  *  It is used to indicate that the message is a standard lobby message.
  259.  *  DPLMSG_SETPROPERTY, DPLMSG_SETPROPERTYRESPONSE, DPLMSG_GETPROPERTY,
  260.  *    DPLMSG_GETPROPERTYRESPONSE
  261.  */
  262. #define DPLMSG_STANDARD                    0x00000002
  263.  
  264.  
  265. /****************************************************************************
  266.  *
  267.  * DirectPlayLobby messages and message data structures
  268.  *
  269.  * All system messages have a dwMessageFlags value of DPLMSG_SYSTEM returned
  270.  * from a call to ReceiveLobbyMessage.
  271.  *
  272.  * All standard messages have a dwMessageFlags value of DPLMSG_STANDARD returned
  273.  * from a call to ReceiveLobbyMessage.
  274.  *
  275.  ****************************************************************************/
  276.  
  277. /*
  278.  * DPLMSG_GENERIC
  279.  * Generic message structure used to identify the message type.
  280.  */
  281. typedef struct _DPLMSG_GENERIC
  282. {
  283.     DWORD       dwType;         // Message type
  284. } DPLMSG_GENERIC, FAR *LPDPLMSG_GENERIC;
  285.  
  286. /*
  287.  *  DPLMSG_SETPROPERTY
  288.  *  Standard message sent by an application to a lobby to set a
  289.  *  property
  290.  */
  291. typedef struct _DPLMSG_SETPROPERTY
  292. {
  293.     DWORD    dwType;                // Message type
  294.     DWORD    dwRequestID;        // Request ID (DPL_NOCONFIRMATION if no confirmation desired)
  295.     GUID    guidPlayer;            // Player GUID
  296.     GUID    guidPropertyTag;    // Property GUID
  297.     DWORD    dwDataSize;            // Size of data
  298.     DWORD    dwPropertyData[1];    // Buffer containing data
  299. } DPLMSG_SETPROPERTY, FAR *LPDPLMSG_SETPROPERTY;
  300.  
  301. #define    DPL_NOCONFIRMATION            0
  302.  
  303. /*
  304.  *  DPLMSG_SETPROPERTYRESPONSE
  305.  *  Standard message returned by a lobby to confirm a 
  306.  *  DPLMSG_SETPROPERTY message.
  307.  */
  308. typedef struct _DPLMSG_SETPROPERTYRESPONSE
  309. {
  310.     DWORD    dwType;                // Message type
  311.     DWORD    dwRequestID;        // Request ID
  312.     GUID    guidPlayer;            // Player GUID
  313.     GUID    guidPropertyTag;    // Property GUID
  314.     HRESULT    hr;                    // Return Code
  315. } DPLMSG_SETPROPERTYRESPONSE, FAR *LPDPLMSG_SETPROPERTYRESPONSE;
  316.  
  317. /*
  318.  *  DPLMSG_GETPROPERTY
  319.  *  Standard message sent by an application to a lobby to request
  320.  *    the current value of a property
  321.  */
  322. typedef struct _DPLMSG_GETPROPERTY
  323. {
  324.     DWORD    dwType;                // Message type
  325.     DWORD    dwRequestID;        // Request ID
  326.     GUID    guidPlayer;            // Player GUID
  327.     GUID    guidPropertyTag;    // Property GUID
  328. } DPLMSG_GETPROPERTY, FAR *LPDPLMSG_GETPROPERTY;
  329.  
  330. /*
  331.  *  DPLMSG_GETPROPERTYRESPONSE
  332.  *  Standard message returned by a lobby in response to a
  333.  *    DPLMSG_GETPROPERTY message.
  334.  */
  335. typedef struct _DPLMSG_GETPROPERTYRESPONSE
  336. {
  337.     DWORD    dwType;                // Message type
  338.     DWORD    dwRequestID;        // Request ID
  339.     GUID    guidPlayer;            // Player GUID
  340.     GUID    guidPropertyTag;    // Property GUID
  341.     HRESULT    hr;                    // Return Code
  342.     DWORD    dwDataSize;            // Size of data
  343.     DWORD    dwPropertyData[1];    // Buffer containing data
  344. } DPLMSG_GETPROPERTYRESPONSE, FAR *LPDPLMSG_GETPROPERTYRESPONSE;
  345.  
  346.  
  347. /******************************************
  348.  *
  349.  *    DirectPlay Lobby message dwType values
  350.  *
  351.  *****************************************/
  352.  
  353. /*
  354.  *  The application has read the connection settings.
  355.  *  It is now O.K. for the lobby client to release
  356.  *  its IDirectPlayLobby interface.
  357.  */
  358. #define DPLSYS_CONNECTIONSETTINGSREAD   0x00000001
  359.  
  360. /*
  361.  *  The application's call to DirectPlayConnect failed
  362.  */
  363. #define DPLSYS_DPLAYCONNECTFAILED       0x00000002
  364.  
  365. /*
  366.  *  The application has created a DirectPlay session.
  367.  */
  368. #define DPLSYS_DPLAYCONNECTSUCCEEDED    0x00000003
  369.  
  370. /*
  371.  *  The application has terminated.
  372.  */
  373. #define DPLSYS_APPTERMINATED            0x00000004
  374.  
  375. /*
  376.  *  The message is a DPLMSG_SETPROPERTY message.
  377.  */
  378. #define DPLSYS_SETPROPERTY                0x00000005
  379.  
  380. /*
  381.  *  The message is a DPLMSG_SETPROPERTYRESPONSE message.
  382.  */
  383. #define DPLSYS_SETPROPERTYRESPONSE        0x00000006
  384.  
  385. /*
  386.  *  The message is a DPLMSG_GETPROPERTY message.
  387.  */
  388. #define DPLSYS_GETPROPERTY                0x00000007
  389.  
  390. /*
  391.  *  The message is a DPLMSG_GETPROPERTYRESPONSE message.
  392.  */
  393. #define DPLSYS_GETPROPERTYRESPONSE        0x00000008
  394.  
  395.  
  396. /****************************************************************************
  397.  *
  398.  * DirectPlay defined property GUIDs and associated data structures
  399.  *
  400.  ****************************************************************************/
  401.  
  402. /*
  403.  * DPLPROPERTY_MessagesSupported
  404.  *
  405.  * Request whether the lobby supports standard.  Lobby with respond with either
  406.  * TRUE or FALSE or may not respond at all.
  407.  * 
  408.  * Property data is a single BOOL with TRUE or FALSE
  409.  */
  410. // {762CCDA1-D916-11d0-BA39-00C04FD7ED67}
  411. DEFINE_GUID(DPLPROPERTY_MessagesSupported, 
  412. 0x762ccda1, 0xd916, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
  413.  
  414. /*
  415.  * DPLPROPERTY_LobbyGuid
  416.  *
  417.  * Request the GUID that identifies the lobby software that the application
  418.  * is communicating with.
  419.  *
  420.  * Property data is a single GUID.
  421.  */
  422. // {F56920A0-D218-11d0-BA39-00C04FD7ED67}
  423. DEFINE_GUID(DPLPROPERTY_LobbyGuid, 
  424. 0xf56920a0, 0xd218, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
  425.  
  426. /*
  427.  * DPLPROPERTY_PlayerGuid
  428.  *
  429.  * Request the GUID that identifies the player on this machine for sending
  430.  * property data back to the lobby.
  431.  *
  432.  * Property data is the DPLDATA_PLAYERDATA structure
  433.  */
  434. // {B4319322-D20D-11d0-BA39-00C04FD7ED67}
  435. DEFINE_GUID(DPLPROPERTY_PlayerGuid, 
  436. 0xb4319322, 0xd20d, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
  437.  
  438. /*
  439.  * DPLDATA_PLAYERGUID
  440.  *
  441.  * Data structure to hold the GUID of the player and player creation flags
  442.  * from the lobby.
  443.  */
  444. typedef struct _DPLDATA_PLAYERGUID
  445. {
  446.     GUID    guidPlayer;
  447.     DWORD    dwPlayerFlags;
  448. } DPLDATA_PLAYERGUID, FAR *LPDPLDATA_PLAYERGUID;
  449.  
  450. /*
  451.  * DPLPROPERTY_PlayerScore
  452.  *
  453.  * Used to send an array of long integers to the lobby indicating the 
  454.  * score of a player.
  455.  *
  456.  * Property data is the DPLDATA_PLAYERSCORE structure.
  457.  */
  458. // {48784000-D219-11d0-BA39-00C04FD7ED67}
  459. DEFINE_GUID(DPLPROPERTY_PlayerScore, 
  460. 0x48784000, 0xd219, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
  461.  
  462. /*
  463.  * DPLDATA_PLAYERSCORE
  464.  *
  465.  * Data structure to hold an array of long integers representing a player score.
  466.  * Application must allocate enough memory to hold all the scores.
  467.  */
  468. typedef struct _DPLDATA_PLAYERSCORE
  469. {
  470.     DWORD    dwScoreCount;
  471.     LONG    Score[1];
  472. } DPLDATA_PLAYERSCORE, FAR *LPDPLDATA_PLAYERSCORE;
  473.  
  474. /****************************************************************************
  475.  *
  476.  * DirectPlay Address ID's
  477.  *
  478.  ****************************************************************************/
  479.  
  480. /* DirectPlay Address
  481.  *
  482.  * A DirectPlay address consists of multiple chunks of data, each tagged
  483.  * with a GUID signifying the type of data in the chunk. The chunk also
  484.  * has a length so that unknown chunk types can be skipped.
  485.  *
  486.  * The EnumAddress() function is used to parse these address data chunks.
  487.  */
  488.  
  489. /*
  490.  * DPADDRESS
  491.  *
  492.  * Header for block of address data elements
  493.  */
  494. typedef struct _DPADDRESS
  495. {
  496.     GUID                guidDataType;
  497.     DWORD               dwDataSize;
  498. } DPADDRESS;
  499.  
  500. typedef DPADDRESS FAR *LPDPADDRESS;
  501.  
  502. /*
  503.  * DPAID_TotalSize
  504.  *
  505.  * Chunk is a DWORD containing size of entire DPADDRESS structure
  506.  */
  507.  
  508. // {1318F560-912C-11d0-9DAA-00A0C90A43CB}
  509. DEFINE_GUID(DPAID_TotalSize, 
  510. 0x1318f560, 0x912c, 0x11d0, 0x9d, 0xaa, 0x0, 0xa0, 0xc9, 0xa, 0x43, 0xcb);
  511.  
  512. /*
  513.  * DPAID_ServiceProvider
  514.  *
  515.  * Chunk is a GUID describing the service provider that created the chunk.
  516.  * All addresses must contain this chunk.
  517.  */
  518.  
  519. // {07D916C0-E0AF-11cf-9C4E-00A0C905425E}
  520. DEFINE_GUID(DPAID_ServiceProvider, 
  521. 0x7d916c0, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
  522.  
  523. /*
  524.  * DPAID_LobbyProvider
  525.  *
  526.  * Chunk is a GUID describing the lobby provider that created the chunk.
  527.  * All addresses must contain this chunk.
  528.  */
  529.  
  530. // {59B95640-9667-11d0-A77D-0000F803ABFC}
  531. DEFINE_GUID(DPAID_LobbyProvider, 
  532. 0x59b95640, 0x9667, 0x11d0, 0xa7, 0x7d, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
  533.  
  534. /*
  535.  * DPAID_Phone and DPAID_PhoneW
  536.  *
  537.  * Chunk is a string containing a phone number (i.e. "1-800-555-1212")
  538.  * in ANSI or UNICODE format
  539.  */
  540.  
  541. // {78EC89A0-E0AF-11cf-9C4E-00A0C905425E}
  542. DEFINE_GUID(DPAID_Phone, 
  543. 0x78ec89a0, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
  544.  
  545. // {BA5A7A70-9DBF-11d0-9CC1-00A0C905425E}
  546. DEFINE_GUID(DPAID_PhoneW, 
  547. 0xba5a7a70, 0x9dbf, 0x11d0, 0x9c, 0xc1, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
  548.  
  549. /*
  550.  * DPAID_Modem and DPAID_ModemW
  551.  *
  552.  * Chunk is a string containing a modem name registered with TAPI
  553.  * in ANSI or UNICODE format
  554.  */
  555.  
  556. // {F6DCC200-A2FE-11d0-9C4F-00A0C905425E}
  557. DEFINE_GUID(DPAID_Modem, 
  558. 0xf6dcc200, 0xa2fe, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
  559.  
  560. // {01FD92E0-A2FF-11d0-9C4F-00A0C905425E}
  561. DEFINE_GUID(DPAID_ModemW, 
  562. 0x1fd92e0, 0xa2ff, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
  563.  
  564. /*
  565.  * DPAID_Inet and DPAID_InetW
  566.  *
  567.  * Chunk is a string containing a TCP/IP host name or an IP address
  568.  * (i.e. "dplay.microsoft.com" or "137.55.100.173") in ANSI or UNICODE format
  569.  */
  570.  
  571. // {C4A54DA0-E0AF-11cf-9C4E-00A0C905425E}
  572. DEFINE_GUID(DPAID_INet, 
  573. 0xc4a54da0, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
  574.  
  575. // {E63232A0-9DBF-11d0-9CC1-00A0C905425E}
  576. DEFINE_GUID(DPAID_INetW, 
  577. 0xe63232a0, 0x9dbf, 0x11d0, 0x9c, 0xc1, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
  578.  
  579. /*
  580.  * DPCOMPORTADDRESS
  581.  *
  582.  * Used to specify com port settings. The constants that define baud rate,
  583.  * stop bits and parity are defined in WINBASE.H. The constants for flow
  584.  * control are given below.
  585.  */
  586.  
  587. #define DPCPA_NOFLOW        0           // no flow control
  588. #define DPCPA_XONXOFFFLOW   1           // software flow control
  589. #define DPCPA_RTSFLOW       2           // hardware flow control with RTS
  590. #define DPCPA_DTRFLOW       3           // hardware flow control with DTR
  591. #define DPCPA_RTSDTRFLOW    4           // hardware flow control with RTS and DTR
  592.  
  593. typedef struct _DPCOMPORTADDRESS
  594. {
  595.     DWORD   dwComPort;                  // COM port to use (1-4)
  596.     DWORD   dwBaudRate;                 // baud rate (100-256k)
  597.     DWORD   dwStopBits;                 // no. stop bits (1-2)
  598.     DWORD   dwParity;                   // parity (none, odd, even, mark)
  599.     DWORD   dwFlowControl;              // flow control (none, xon/xoff, rts, dtr)
  600. } DPCOMPORTADDRESS;
  601.  
  602. typedef DPCOMPORTADDRESS FAR *LPDPCOMPORTADDRESS;
  603.  
  604. /*
  605.  * DPAID_ComPort
  606.  *
  607.  * Chunk contains a DPCOMPORTADDRESS structure defining the serial port.
  608.  */
  609.  
  610. // {F2F0CE00-E0AF-11cf-9C4E-00A0C905425E}
  611. DEFINE_GUID(DPAID_ComPort, 
  612. 0xf2f0ce00, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
  613.  
  614. /****************************************************************************
  615.  *
  616.  *     dplobby 1.0 obsolete definitions
  617.  *    Included for compatibility only.
  618.  *
  619.  ****************************************************************************/
  620. #define DPLAD_SYSTEM          DPLMSG_SYSTEM
  621.  
  622.  
  623. #ifdef __cplusplus
  624. };
  625. #endif /* __cplusplus */
  626.  
  627. #endif /* __DPLOBBY_INCLUDED__ */
  628.