/[cvs]/api/include/dplobby.h
ViewVC logotype

Annotation of /api/include/dplobby.h

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.1.1.1 - (hide annotations) (vendor branch)
Sun Jul 1 20:47:59 2001 UTC (23 years, 4 months ago) by bearsoft
Branch: lazy, MAIN
CVS Tags: start, HEAD
Changes since 1.1: +0 -0 lines
File MIME type: text/plain
First import

1 bearsoft 1.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     /* avoid warnings at Level 4 */
14     #pragma warning(disable:4201)
15    
16     #ifdef __cplusplus
17     extern "C" {
18     #endif /* __cplusplus */
19    
20     /*
21     * GUIDS used by DirectPlay objects
22     */
23    
24     /* {AF465C71-9588-11cf-A020-00AA006157AC} */
25     DEFINE_GUID(IID_IDirectPlayLobby, 0xaf465c71, 0x9588, 0x11cf, 0xa0, 0x20, 0x0, 0xaa, 0x0, 0x61, 0x57, 0xac);
26     /* {26C66A70-B367-11cf-A024-00AA006157AC} */
27     DEFINE_GUID(IID_IDirectPlayLobbyA, 0x26c66a70, 0xb367, 0x11cf, 0xa0, 0x24, 0x0, 0xaa, 0x0, 0x61, 0x57, 0xac);
28     /* {0194C220-A303-11d0-9C4F-00A0C905425E} */
29     DEFINE_GUID(IID_IDirectPlayLobby2, 0x194c220, 0xa303, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
30     /* {1BB4AF80-A303-11d0-9C4F-00A0C905425E} */
31     DEFINE_GUID(IID_IDirectPlayLobby2A, 0x1bb4af80, 0xa303, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
32     /* {2DB72490-652C-11d1-A7A8-0000F803ABFC} */
33     DEFINE_GUID(IID_IDirectPlayLobby3, 0x2db72490, 0x652c, 0x11d1, 0xa7, 0xa8, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
34     /* {2DB72491-652C-11d1-A7A8-0000F803ABFC} */
35     DEFINE_GUID(IID_IDirectPlayLobby3A, 0x2db72491, 0x652c, 0x11d1, 0xa7, 0xa8, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
36     /* {2FE8F810-B2A5-11d0-A787-0000F803ABFC} */
37     DEFINE_GUID(CLSID_DirectPlayLobby, 0x2fe8f810, 0xb2a5, 0x11d0, 0xa7, 0x87, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
38    
39    
40     /****************************************************************************
41     *
42     * IDirectPlayLobby Structures
43     *
44     * Various structures used to invoke DirectPlayLobby.
45     *
46     ****************************************************************************/
47    
48     typedef struct IDirectPlayLobby FAR *LPDIRECTPLAYLOBBY;
49     typedef struct IDirectPlayLobby FAR *LPDIRECTPLAYLOBBYA;
50     typedef struct IDirectPlayLobby IDirectPlayLobbyA;
51    
52     typedef struct IDirectPlayLobby2 FAR *LPDIRECTPLAYLOBBY2;
53     typedef struct IDirectPlayLobby2 FAR *LPDIRECTPLAYLOBBY2A;
54     typedef struct IDirectPlayLobby2 IDirectPlayLobby2A;
55    
56     typedef struct IDirectPlayLobby3 FAR *LPDIRECTPLAYLOBBY3;
57     typedef struct IDirectPlayLobby3 FAR *LPDIRECTPLAYLOBBY3A;
58     typedef struct IDirectPlayLobby3 IDirectPlayLobby3A;
59    
60    
61     /*
62     * DPLAPPINFO
63     * Used to hold information about a registered DirectPlay
64     * application
65     */
66     typedef struct DPLAPPINFO
67     {
68     DWORD dwSize; // Size of this structure
69     GUID guidApplication; // GUID of the Application
70     union
71     {
72     LPSTR lpszAppNameA; // Pointer to the Application Name
73     LPWSTR lpszAppName;
74     };
75    
76     } DPLAPPINFO, FAR *LPDPLAPPINFO;
77    
78     /*
79     * LPCDPLAPPINFO
80     * A constant pointer to DPLAPPINFO
81     */
82     typedef const DPLAPPINFO FAR *LPCDPLAPPINFO;
83    
84     /*
85     * DPCOMPOUNDADDRESSELEMENT
86     *
87     * An array of these is passed to CreateCompoundAddresses()
88     */
89     typedef struct DPCOMPOUNDADDRESSELEMENT
90     {
91     GUID guidDataType;
92     DWORD dwDataSize;
93     LPVOID lpData;
94     } DPCOMPOUNDADDRESSELEMENT, FAR *LPDPCOMPOUNDADDRESSELEMENT;
95    
96     /*
97     * LPCDPCOMPOUNDADDRESSELEMENT
98     * A constant pointer to DPCOMPOUNDADDRESSELEMENT
99     */
100     typedef const DPCOMPOUNDADDRESSELEMENT FAR *LPCDPCOMPOUNDADDRESSELEMENT;
101    
102     /*
103     * LPDPAPPLICATIONDESC
104     * Used to register a DirectPlay application
105     */
106     typedef struct DPAPPLICATIONDESC
107     {
108     DWORD dwSize;
109     DWORD dwFlags;
110     union
111     {
112     LPSTR lpszApplicationNameA;
113     LPWSTR lpszApplicationName;
114     };
115     GUID guidApplication;
116     union
117     {
118     LPSTR lpszFilenameA;
119     LPWSTR lpszFilename;
120     };
121     union
122     {
123     LPSTR lpszCommandLineA;
124     LPWSTR lpszCommandLine;
125     };
126     union
127     {
128     LPSTR lpszPathA;
129     LPWSTR lpszPath;
130     };
131     union
132     {
133     LPSTR lpszCurrentDirectoryA;
134     LPWSTR lpszCurrentDirectory;
135     };
136     LPSTR lpszDescriptionA;
137     LPWSTR lpszDescriptionW;
138     } DPAPPLICATIONDESC, *LPDPAPPLICATIONDESC;
139    
140     /*
141     * LPDPAPPLICATIONDESC2
142     * Used to register a DirectPlay application
143     */
144     typedef struct DPAPPLICATIONDESC2
145     {
146     DWORD dwSize;
147     DWORD dwFlags;
148     union
149     {
150     LPSTR lpszApplicationNameA;
151     LPWSTR lpszApplicationName;
152     };
153     GUID guidApplication;
154     union
155     {
156     LPSTR lpszFilenameA;
157     LPWSTR lpszFilename;
158     };
159     union
160     {
161     LPSTR lpszCommandLineA;
162     LPWSTR lpszCommandLine;
163     };
164     union
165     {
166     LPSTR lpszPathA;
167     LPWSTR lpszPath;
168     };
169     union
170     {
171     LPSTR lpszCurrentDirectoryA;
172     LPWSTR lpszCurrentDirectory;
173     };
174     LPSTR lpszDescriptionA;
175     LPWSTR lpszDescriptionW;
176     union
177     {
178     LPSTR lpszAppLauncherNameA;
179     LPWSTR lpszAppLauncherName;
180     };
181     } DPAPPLICATIONDESC2, *LPDPAPPLICATIONDESC2;
182    
183    
184     /****************************************************************************
185     *
186     * Enumeration Method Callback Prototypes
187     *
188     ****************************************************************************/
189    
190     /*
191     * Callback for EnumAddress()
192     */
193     typedef BOOL (FAR PASCAL *LPDPENUMADDRESSCALLBACK)(
194     REFGUID guidDataType,
195     DWORD dwDataSize,
196     LPCVOID lpData,
197     LPVOID lpContext);
198    
199     /*
200     * Callback for EnumAddressTypes()
201     */
202     typedef BOOL (FAR PASCAL *LPDPLENUMADDRESSTYPESCALLBACK)(
203     REFGUID guidDataType,
204     LPVOID lpContext,
205     DWORD dwFlags);
206    
207     /*
208     * Callback for EnumLocalApplications()
209     */
210     typedef BOOL (FAR PASCAL * LPDPLENUMLOCALAPPLICATIONSCALLBACK)(
211     LPCDPLAPPINFO lpAppInfo,
212     LPVOID lpContext,
213     DWORD dwFlags);
214    
215    
216     /****************************************************************************
217     *
218     * DirectPlayLobby API Prototypes
219     *
220     ****************************************************************************/
221     #ifdef UNICODE
222     #define DirectPlayLobbyCreate DirectPlayLobbyCreateW
223     #else
224     #define DirectPlayLobbyCreate DirectPlayLobbyCreateA
225     #endif /* UNICODE */
226    
227     extern HRESULT WINAPI DirectPlayLobbyCreateW(LPGUID, LPDIRECTPLAYLOBBY *, IUnknown *, LPVOID, DWORD );
228     extern HRESULT WINAPI DirectPlayLobbyCreateA(LPGUID, LPDIRECTPLAYLOBBYA *, IUnknown *, LPVOID, DWORD );
229    
230    
231     /****************************************************************************
232     *
233     * IDirectPlayLobby (and IDirectPlayLobbyA) Interface
234     *
235     ****************************************************************************/
236     #undef INTERFACE
237     #define INTERFACE IDirectPlayLobby
238     DECLARE_INTERFACE_( IDirectPlayLobby, IUnknown )
239     {
240     /* IUnknown Methods */
241     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
242     STDMETHOD_(ULONG,AddRef) (THIS) PURE;
243     STDMETHOD_(ULONG,Release) (THIS) PURE;
244    
245     /* IDirectPlayLobby Methods */
246     STDMETHOD(Connect) (THIS_ DWORD, LPDIRECTPLAY2 *, IUnknown FAR *) PURE;
247     STDMETHOD(CreateAddress) (THIS_ REFGUID, REFGUID, LPCVOID, DWORD, LPVOID, LPDWORD) PURE;
248     STDMETHOD(EnumAddress) (THIS_ LPDPENUMADDRESSCALLBACK, LPCVOID, DWORD, LPVOID) PURE;
249     STDMETHOD(EnumAddressTypes) (THIS_ LPDPLENUMADDRESSTYPESCALLBACK, REFGUID, LPVOID, DWORD) PURE;
250     STDMETHOD(EnumLocalApplications)(THIS_ LPDPLENUMLOCALAPPLICATIONSCALLBACK, LPVOID, DWORD) PURE;
251     STDMETHOD(GetConnectionSettings)(THIS_ DWORD, LPVOID, LPDWORD) PURE;
252     STDMETHOD(ReceiveLobbyMessage) (THIS_ DWORD, DWORD, LPDWORD, LPVOID, LPDWORD) PURE;
253     STDMETHOD(RunApplication) (THIS_ DWORD, LPDWORD, LPDPLCONNECTION, HANDLE) PURE;
254     STDMETHOD(SendLobbyMessage) (THIS_ DWORD, DWORD, LPVOID, DWORD) PURE;
255     STDMETHOD(SetConnectionSettings)(THIS_ DWORD, DWORD, LPDPLCONNECTION) PURE;
256     STDMETHOD(SetLobbyMessageEvent) (THIS_ DWORD, DWORD, HANDLE) PURE;
257    
258     };
259    
260     /****************************************************************************
261     *
262     * IDirectPlayLobby2 (and IDirectPlayLobby2A) Interface
263     *
264     ****************************************************************************/
265     #undef INTERFACE
266     #define INTERFACE IDirectPlayLobby2
267     DECLARE_INTERFACE_( IDirectPlayLobby2, IDirectPlayLobby )
268     {
269     /* IUnknown Methods */
270     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
271     STDMETHOD_(ULONG,AddRef) (THIS) PURE;
272     STDMETHOD_(ULONG,Release) (THIS) PURE;
273    
274     /* IDirectPlayLobby Methods */
275     STDMETHOD(Connect) (THIS_ DWORD, LPDIRECTPLAY2 *, IUnknown FAR *) PURE;
276     STDMETHOD(CreateAddress) (THIS_ REFGUID, REFGUID, LPCVOID, DWORD, LPVOID, LPDWORD) PURE;
277     STDMETHOD(EnumAddress) (THIS_ LPDPENUMADDRESSCALLBACK, LPCVOID, DWORD, LPVOID) PURE;
278     STDMETHOD(EnumAddressTypes) (THIS_ LPDPLENUMADDRESSTYPESCALLBACK, REFGUID, LPVOID, DWORD) PURE;
279     STDMETHOD(EnumLocalApplications)(THIS_ LPDPLENUMLOCALAPPLICATIONSCALLBACK, LPVOID, DWORD) PURE;
280     STDMETHOD(GetConnectionSettings)(THIS_ DWORD, LPVOID, LPDWORD) PURE;
281     STDMETHOD(ReceiveLobbyMessage) (THIS_ DWORD, DWORD, LPDWORD, LPVOID, LPDWORD) PURE;
282     STDMETHOD(RunApplication) (THIS_ DWORD, LPDWORD, LPDPLCONNECTION, HANDLE) PURE;
283     STDMETHOD(SendLobbyMessage) (THIS_ DWORD, DWORD, LPVOID, DWORD) PURE;
284     STDMETHOD(SetConnectionSettings)(THIS_ DWORD, DWORD, LPDPLCONNECTION) PURE;
285     STDMETHOD(SetLobbyMessageEvent) (THIS_ DWORD, DWORD, HANDLE) PURE;
286    
287     /* IDirectPlayLobby2 Methods */
288     STDMETHOD(CreateCompoundAddress)(THIS_ LPCDPCOMPOUNDADDRESSELEMENT,DWORD,LPVOID,LPDWORD) PURE;
289     };
290    
291     /****************************************************************************
292     *
293     * IDirectPlayLobby3 (and IDirectPlayLobby3A) Interface
294     *
295     ****************************************************************************/
296     #undef INTERFACE
297     #define INTERFACE IDirectPlayLobby3
298     DECLARE_INTERFACE_( IDirectPlayLobby3, IDirectPlayLobby )
299     {
300     /* IUnknown Methods */
301     STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
302     STDMETHOD_(ULONG,AddRef) (THIS) PURE;
303     STDMETHOD_(ULONG,Release) (THIS) PURE;
304    
305     /* IDirectPlayLobby Methods */
306     STDMETHOD(Connect) (THIS_ DWORD, LPDIRECTPLAY2 *, IUnknown FAR *) PURE;
307     STDMETHOD(CreateAddress) (THIS_ REFGUID, REFGUID, LPCVOID, DWORD, LPVOID, LPDWORD) PURE;
308     STDMETHOD(EnumAddress) (THIS_ LPDPENUMADDRESSCALLBACK, LPCVOID, DWORD, LPVOID) PURE;
309     STDMETHOD(EnumAddressTypes) (THIS_ LPDPLENUMADDRESSTYPESCALLBACK, REFGUID, LPVOID, DWORD) PURE;
310     STDMETHOD(EnumLocalApplications)(THIS_ LPDPLENUMLOCALAPPLICATIONSCALLBACK, LPVOID, DWORD) PURE;
311     STDMETHOD(GetConnectionSettings)(THIS_ DWORD, LPVOID, LPDWORD) PURE;
312     STDMETHOD(ReceiveLobbyMessage) (THIS_ DWORD, DWORD, LPDWORD, LPVOID, LPDWORD) PURE;
313     STDMETHOD(RunApplication) (THIS_ DWORD, LPDWORD, LPDPLCONNECTION, HANDLE) PURE;
314     STDMETHOD(SendLobbyMessage) (THIS_ DWORD, DWORD, LPVOID, DWORD) PURE;
315     STDMETHOD(SetConnectionSettings)(THIS_ DWORD, DWORD, LPDPLCONNECTION) PURE;
316     STDMETHOD(SetLobbyMessageEvent) (THIS_ DWORD, DWORD, HANDLE) PURE;
317    
318     /* IDirectPlayLobby2 Methods */
319     STDMETHOD(CreateCompoundAddress)(THIS_ LPCDPCOMPOUNDADDRESSELEMENT,DWORD,LPVOID,LPDWORD) PURE;
320    
321     /* IDirectPlayLobby3 Methods */
322     STDMETHOD(ConnectEx) (THIS_ DWORD, REFIID, LPVOID *, IUnknown FAR *) PURE;
323     STDMETHOD(RegisterApplication) (THIS_ DWORD, LPVOID) PURE;
324     STDMETHOD(UnregisterApplication)(THIS_ DWORD, REFGUID) PURE;
325     STDMETHOD(WaitForConnectionSettings)(THIS_ DWORD) PURE;
326     };
327    
328     /****************************************************************************
329     *
330     * IDirectPlayLobby interface macros
331     *
332     ****************************************************************************/
333    
334     #if !defined(__cplusplus) || defined(CINTERFACE)
335    
336     #define IDirectPlayLobby_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
337     #define IDirectPlayLobby_AddRef(p) (p)->lpVtbl->AddRef(p)
338     #define IDirectPlayLobby_Release(p) (p)->lpVtbl->Release(p)
339     #define IDirectPlayLobby_Connect(p,a,b,c) (p)->lpVtbl->Connect(p,a,b,c)
340     #define IDirectPlayLobby_ConnectEx(p,a,b,c,d) (p)->lpVtbl->ConnectEx(p,a,b,c,d)
341     #define IDirectPlayLobby_CreateAddress(p,a,b,c,d,e,f) (p)->lpVtbl->CreateAddress(p,a,b,c,d,e,f)
342     #define IDirectPlayLobby_CreateCompoundAddress(p,a,b,c,d) (p)->lpVtbl->CreateCompoundAddress(p,a,b,c,d)
343     #define IDirectPlayLobby_EnumAddress(p,a,b,c,d) (p)->lpVtbl->EnumAddress(p,a,b,c,d)
344     #define IDirectPlayLobby_EnumAddressTypes(p,a,b,c,d) (p)->lpVtbl->EnumAddressTypes(p,a,b,c,d)
345     #define IDirectPlayLobby_EnumLocalApplications(p,a,b,c) (p)->lpVtbl->EnumLocalApplications(p,a,b,c)
346     #define IDirectPlayLobby_GetConnectionSettings(p,a,b,c) (p)->lpVtbl->GetConnectionSettings(p,a,b,c)
347     #define IDirectPlayLobby_ReceiveLobbyMessage(p,a,b,c,d,e) (p)->lpVtbl->ReceiveLobbyMessage(p,a,b,c,d,e)
348     #define IDirectPlayLobby_RegisterApplication(p,a,b) (p)->lpVtbl->RegisterApplication(p,a,b)
349     #define IDirectPlayLobby_RunApplication(p,a,b,c,d) (p)->lpVtbl->RunApplication(p,a,b,c,d)
350     #define IDirectPlayLobby_SendLobbyMessage(p,a,b,c,d) (p)->lpVtbl->SendLobbyMessage(p,a,b,c,d)
351     #define IDirectPlayLobby_SetConnectionSettings(p,a,b,c) (p)->lpVtbl->SetConnectionSettings(p,a,b,c)
352     #define IDirectPlayLobby_SetLobbyMessageEvent(p,a,b,c) (p)->lpVtbl->SetLobbyMessageEvent(p,a,b,c)
353     #define IDirectPlayLobby_UnregisterApplication(p,a,b) (p)->lpVtbl->UnregisterApplication(p,a,b)
354     #define IDirectPlayLobby_WaitForConnectionSettings(p,a) (p)->lpVtbl->WaitForConnectionSettings(p,a)
355    
356     #else /* C++ */
357    
358     #define IDirectPlayLobby_QueryInterface(p,a,b) (p)->QueryInterface(a,b)
359     #define IDirectPlayLobby_AddRef(p) (p)->AddRef()
360     #define IDirectPlayLobby_Release(p) (p)->Release()
361     #define IDirectPlayLobby_Connect(p,a,b,c) (p)->Connect(a,b,c)
362     #define IDirectPlayLobby_ConnectEx(p,a,b,c,d) (p)->ConnectEx(a,b,c,d)
363     #define IDirectPlayLobby_CreateAddress(p,a,b,c,d,e,f) (p)->CreateAddress(a,b,c,d,e,f)
364     #define IDirectPlayLobby_CreateCompoundAddress(p,a,b,c,d) (p)->CreateCompoundAddress(a,b,c,d)
365     #define IDirectPlayLobby_EnumAddress(p,a,b,c,d) (p)->EnumAddress(a,b,c,d)
366     #define IDirectPlayLobby_EnumAddressTypes(p,a,b,c,d) (p)->EnumAddressTypes(a,b,c,d)
367     #define IDirectPlayLobby_EnumLocalApplications(p,a,b,c) (p)->EnumLocalApplications(a,b,c)
368     #define IDirectPlayLobby_GetConnectionSettings(p,a,b,c) (p)->GetConnectionSettings(a,b,c)
369     #define IDirectPlayLobby_ReceiveLobbyMessage(p,a,b,c,d,e) (p)->ReceiveLobbyMessage(a,b,c,d,e)
370     #define IDirectPlayLobby_RegisterApplication(p,a,b) (p)->RegisterApplication(a,b)
371     #define IDirectPlayLobby_RunApplication(p,a,b,c,d) (p)->RunApplication(a,b,c,d)
372     #define IDirectPlayLobby_SendLobbyMessage(p,a,b,c,d) (p)->SendLobbyMessage(a,b,c,d)
373     #define IDirectPlayLobby_SetConnectionSettings(p,a,b,c) (p)->SetConnectionSettings(a,b,c)
374     #define IDirectPlayLobby_SetLobbyMessageEvent(p,a,b,c) (p)->SetLobbyMessageEvent(a,b,c)
375     #define IDirectPlayLobby_UnregisterApplication(p,a,b) (p)->UnregisterApplication(a,b)
376     #define IDirectPlayLobby_WaitForConnectionSettings(p,a) (p)->WaitForConnectionSettings(a)
377    
378     #endif
379    
380     /****************************************************************************
381     *
382     * DirectPlayLobby Flags
383     *
384     ****************************************************************************/
385    
386     /*
387     * This flag is used by IDirectPlayLobby->WaitForConnectionSettings to
388     * cancel a current wait that is in progress.
389     */
390     #define DPLWAIT_CANCEL 0x00000001
391    
392    
393     /*
394     * This is a message flag used by ReceiveLobbyMessage. It can be
395     * returned in the dwMessageFlags parameter to indicate a message from
396     * the system.
397     */
398     #define DPLMSG_SYSTEM 0x00000001
399    
400     /*
401     * This is a message flag used by ReceiveLobbyMessage and SendLobbyMessage.
402     * It is used to indicate that the message is a standard lobby message.
403     * DPLMSG_SETPROPERTY, DPLMSG_SETPROPERTYRESPONSE, DPLMSG_GETPROPERTY,
404     * DPLMSG_GETPROPERTYRESPONSE
405     */
406     #define DPLMSG_STANDARD 0x00000002
407    
408     /*
409     * Lobbyable Application registration flags
410     */
411    
412     /*
413     * Applications registered with this flag will not show up when
414     * applications are enumerated in the lobby. This application
415     * will only be able to be launched by a lobby client that already
416     * knows about the application.
417     */
418     #define DPLAPP_NOENUM 0x80000000
419    
420     /*
421     * Applications registered with this flag want voice to automatically
422     * be enabled for their application. All players will be launched into
423     * an 'n'-way voice conference when the application is started. The
424     * user will be able to enable this flag for existing non-voice
425     * directplay applications.
426     */
427     #define DPLAPP_AUTOVOICE 0x00000001
428    
429     /*
430     * Applications that do their own voice conferencing should register with
431     * this flag to avoid allowing the user to enable other voice chat
432     * capabilites during the same session. This is to avoid users forcing
433     * the DPLAPP_AUTOVOICE flag for the application.
434     */
435     #define DPLAPP_SELFVOICE 0x00000002
436    
437     /****************************************************************************
438     *
439     * DirectPlayLobby messages and message data structures
440     *
441     * All system messages have a dwMessageFlags value of DPLMSG_SYSTEM returned
442     * from a call to ReceiveLobbyMessage.
443     *
444     * All standard messages have a dwMessageFlags value of DPLMSG_STANDARD returned
445     * from a call to ReceiveLobbyMessage.
446     *
447     ****************************************************************************/
448    
449     /*
450     * DPLMSG_GENERIC
451     * Generic message structure used to identify the message type.
452     */
453     typedef struct _DPLMSG_GENERIC
454     {
455     DWORD dwType; // Message type
456     } DPLMSG_GENERIC, FAR *LPDPLMSG_GENERIC;
457    
458     /*
459     * DPLMSG_SYSTEMMESSAGE
460     * Generic message format for all system messages --
461     * DPLSYS_CONNECTIONSETTINGSREAD, DPLSYS_DPLYCONNECTSUCCEEDED,
462     * DPLSYS_DPLAYCONNECTFAILED, DPLSYS_APPTERMINATED, DPLSYS_NEWCONNECTIONSETTINGS
463     */
464     typedef struct _DPLMSG_SYSTEMMESSAGE
465     {
466     DWORD dwType; // Message type
467     GUID guidInstance; // Instance GUID of the dplay session the message corresponds to
468     } DPLMSG_SYSTEMMESSAGE, FAR *LPDPLMSG_SYSTEMMESSAGE;
469    
470     /*
471     * DPLMSG_SETPROPERTY
472     * Standard message sent by an application to a lobby to set a
473     * property
474     */
475     typedef struct _DPLMSG_SETPROPERTY
476     {
477     DWORD dwType; // Message type
478     DWORD dwRequestID; // Request ID (DPL_NOCONFIRMATION if no confirmation desired)
479     GUID guidPlayer; // Player GUID
480     GUID guidPropertyTag; // Property GUID
481     DWORD dwDataSize; // Size of data
482     DWORD dwPropertyData[1]; // Buffer containing data
483     } DPLMSG_SETPROPERTY, FAR *LPDPLMSG_SETPROPERTY;
484    
485     #define DPL_NOCONFIRMATION 0
486    
487     /*
488     * DPLMSG_SETPROPERTYRESPONSE
489     * Standard message returned by a lobby to confirm a
490     * DPLMSG_SETPROPERTY message.
491     */
492     typedef struct _DPLMSG_SETPROPERTYRESPONSE
493     {
494     DWORD dwType; // Message type
495     DWORD dwRequestID; // Request ID
496     GUID guidPlayer; // Player GUID
497     GUID guidPropertyTag; // Property GUID
498     HRESULT hr; // Return Code
499     } DPLMSG_SETPROPERTYRESPONSE, FAR *LPDPLMSG_SETPROPERTYRESPONSE;
500    
501     /*
502     * DPLMSG_GETPROPERTY
503     * Standard message sent by an application to a lobby to request
504     * the current value of a property
505     */
506     typedef struct _DPLMSG_GETPROPERTY
507     {
508     DWORD dwType; // Message type
509     DWORD dwRequestID; // Request ID
510     GUID guidPlayer; // Player GUID
511     GUID guidPropertyTag; // Property GUID
512     } DPLMSG_GETPROPERTY, FAR *LPDPLMSG_GETPROPERTY;
513    
514     /*
515     * DPLMSG_GETPROPERTYRESPONSE
516     * Standard message returned by a lobby in response to a
517     * DPLMSG_GETPROPERTY message.
518     */
519     typedef struct _DPLMSG_GETPROPERTYRESPONSE
520     {
521     DWORD dwType; // Message type
522     DWORD dwRequestID; // Request ID
523     GUID guidPlayer; // Player GUID
524     GUID guidPropertyTag; // Property GUID
525     HRESULT hr; // Return Code
526     DWORD dwDataSize; // Size of data
527     DWORD dwPropertyData[1]; // Buffer containing data
528     } DPLMSG_GETPROPERTYRESPONSE, FAR *LPDPLMSG_GETPROPERTYRESPONSE;
529    
530     /*
531     * DPLMSG_NEWSESSIONHOST
532     * Standard message returned by a lobby in response to a
533     * the session host migrating to a new client
534     */
535     typedef struct _DPLMSG_NEWSESSIONHOST
536     {
537     DWORD dwType; // Message type
538     GUID guidInstance; // GUID Instance of the session
539     } DPLMSG_NEWSESSIONHOST, FAR *LPDPLMSG_NEWSESSIONHOST;
540    
541    
542     /******************************************
543     *
544     * DirectPlay Lobby message dwType values
545     *
546     *****************************************/
547    
548     /*
549     * The application has read the connection settings.
550     * It is now O.K. for the lobby client to release
551     * its IDirectPlayLobby interface.
552     */
553     #define DPLSYS_CONNECTIONSETTINGSREAD 0x00000001
554    
555     /*
556     * The application's call to DirectPlayConnect failed
557     */
558     #define DPLSYS_DPLAYCONNECTFAILED 0x00000002
559    
560     /*
561     * The application has created a DirectPlay session.
562     */
563     #define DPLSYS_DPLAYCONNECTSUCCEEDED 0x00000003
564    
565     /*
566     * The application has terminated.
567     */
568     #define DPLSYS_APPTERMINATED 0x00000004
569    
570     /*
571     * The message is a DPLMSG_SETPROPERTY message.
572     */
573     #define DPLSYS_SETPROPERTY 0x00000005
574    
575     /*
576     * The message is a DPLMSG_SETPROPERTYRESPONSE message.
577     */
578     #define DPLSYS_SETPROPERTYRESPONSE 0x00000006
579    
580     /*
581     * The message is a DPLMSG_GETPROPERTY message.
582     */
583     #define DPLSYS_GETPROPERTY 0x00000007
584    
585     /*
586     * The message is a DPLMSG_GETPROPERTYRESPONSE message.
587     */
588     #define DPLSYS_GETPROPERTYRESPONSE 0x00000008
589    
590     /*
591     * The message is a DPLMSG_NEWSESSIONHOST message.
592     */
593     #define DPLSYS_NEWSESSIONHOST 0x00000009
594    
595     /*
596     * New connection settings are available.
597     */
598     #define DPLSYS_NEWCONNECTIONSETTINGS 0x0000000A
599    
600     /*
601     * The Lobby Client has released the DirectPlayLobby Interface
602     */
603     #define DPLSYS_LOBBYCLIENTRELEASE 0x0000000B
604    
605     /****************************************************************************
606     *
607     * DirectPlay defined property GUIDs and associated data structures
608     *
609     ****************************************************************************/
610    
611     /*
612     * DPLPROPERTY_MessagesSupported
613     *
614     * Request whether the lobby supports standard. Lobby with respond with either
615     * TRUE or FALSE or may not respond at all.
616     *
617     * Property data is a single BOOL with TRUE or FALSE
618     */
619     // {762CCDA1-D916-11d0-BA39-00C04FD7ED67}
620     DEFINE_GUID(DPLPROPERTY_MessagesSupported,
621     0x762ccda1, 0xd916, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
622    
623     /*
624     * DPLPROPERTY_LobbyGuid
625     *
626     * Request the GUID that identifies the lobby software that the application
627     * is communicating with.
628     *
629     * Property data is a single GUID.
630     */
631     // {F56920A0-D218-11d0-BA39-00C04FD7ED67}
632     DEFINE_GUID(DPLPROPERTY_LobbyGuid,
633     0xf56920a0, 0xd218, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
634    
635     /*
636     * DPLPROPERTY_PlayerGuid
637     *
638     * Request the GUID that identifies the player on this machine for sending
639     * property data back to the lobby.
640     *
641     * Property data is the DPLDATA_PLAYERDATA structure
642     */
643     // {B4319322-D20D-11d0-BA39-00C04FD7ED67}
644     DEFINE_GUID(DPLPROPERTY_PlayerGuid,
645     0xb4319322, 0xd20d, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
646    
647     /*
648     * DPLDATA_PLAYERGUID
649     *
650     * Data structure to hold the GUID of the player and player creation flags
651     * from the lobby.
652     */
653     typedef struct _DPLDATA_PLAYERGUID
654     {
655     GUID guidPlayer;
656     DWORD dwPlayerFlags;
657     } DPLDATA_PLAYERGUID, FAR *LPDPLDATA_PLAYERGUID;
658    
659     /*
660     * DPLPROPERTY_PlayerScore
661     *
662     * Used to send an array of long integers to the lobby indicating the
663     * score of a player.
664     *
665     * Property data is the DPLDATA_PLAYERSCORE structure.
666     */
667     // {48784000-D219-11d0-BA39-00C04FD7ED67}
668     DEFINE_GUID(DPLPROPERTY_PlayerScore,
669     0x48784000, 0xd219, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
670    
671     /*
672     * DPLDATA_PLAYERSCORE
673     *
674     * Data structure to hold an array of long integers representing a player score.
675     * Application must allocate enough memory to hold all the scores.
676     */
677     typedef struct _DPLDATA_PLAYERSCORE
678     {
679     DWORD dwScoreCount;
680     LONG Score[1];
681     } DPLDATA_PLAYERSCORE, FAR *LPDPLDATA_PLAYERSCORE;
682    
683     /****************************************************************************
684     *
685     * DirectPlay Address ID's
686     *
687     ****************************************************************************/
688    
689     /* DirectPlay Address
690     *
691     * A DirectPlay address consists of multiple chunks of data, each tagged
692     * with a GUID signifying the type of data in the chunk. The chunk also
693     * has a length so that unknown chunk types can be skipped.
694     *
695     * The EnumAddress() function is used to parse these address data chunks.
696     */
697    
698     /*
699     * DPADDRESS
700     *
701     * Header for block of address data elements
702     */
703     typedef struct _DPADDRESS
704     {
705     GUID guidDataType;
706     DWORD dwDataSize;
707     } DPADDRESS;
708    
709     typedef DPADDRESS FAR *LPDPADDRESS;
710    
711     /*
712     * DPAID_TotalSize
713     *
714     * Chunk is a DWORD containing size of entire DPADDRESS structure
715     */
716    
717     // {1318F560-912C-11d0-9DAA-00A0C90A43CB}
718     DEFINE_GUID(DPAID_TotalSize,
719     0x1318f560, 0x912c, 0x11d0, 0x9d, 0xaa, 0x0, 0xa0, 0xc9, 0xa, 0x43, 0xcb);
720    
721     /*
722     * DPAID_ServiceProvider
723     *
724     * Chunk is a GUID describing the service provider that created the chunk.
725     * All addresses must contain this chunk.
726     */
727    
728     // {07D916C0-E0AF-11cf-9C4E-00A0C905425E}
729     DEFINE_GUID(DPAID_ServiceProvider,
730     0x7d916c0, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
731    
732     /*
733     * DPAID_LobbyProvider
734     *
735     * Chunk is a GUID describing the lobby provider that created the chunk.
736     * All addresses must contain this chunk.
737     */
738    
739     // {59B95640-9667-11d0-A77D-0000F803ABFC}
740     DEFINE_GUID(DPAID_LobbyProvider,
741     0x59b95640, 0x9667, 0x11d0, 0xa7, 0x7d, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
742    
743     /*
744     * DPAID_Phone and DPAID_PhoneW
745     *
746     * Chunk is a string containing a phone number (i.e. "1-800-555-1212")
747     * in ANSI or UNICODE format
748     */
749    
750     // {78EC89A0-E0AF-11cf-9C4E-00A0C905425E}
751     DEFINE_GUID(DPAID_Phone,
752     0x78ec89a0, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
753    
754     // {BA5A7A70-9DBF-11d0-9CC1-00A0C905425E}
755     DEFINE_GUID(DPAID_PhoneW,
756     0xba5a7a70, 0x9dbf, 0x11d0, 0x9c, 0xc1, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
757    
758     /*
759     * DPAID_Modem and DPAID_ModemW
760     *
761     * Chunk is a string containing a modem name registered with TAPI
762     * in ANSI or UNICODE format
763     */
764    
765     // {F6DCC200-A2FE-11d0-9C4F-00A0C905425E}
766     DEFINE_GUID(DPAID_Modem,
767     0xf6dcc200, 0xa2fe, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
768    
769     // {01FD92E0-A2FF-11d0-9C4F-00A0C905425E}
770     DEFINE_GUID(DPAID_ModemW,
771     0x1fd92e0, 0xa2ff, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
772    
773     /*
774     * DPAID_Inet and DPAID_InetW
775     *
776     * Chunk is a string containing a TCP/IP host name or an IP address
777     * (i.e. "dplay.microsoft.com" or "137.55.100.173") in ANSI or UNICODE format
778     */
779    
780     // {C4A54DA0-E0AF-11cf-9C4E-00A0C905425E}
781     DEFINE_GUID(DPAID_INet,
782     0xc4a54da0, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
783    
784     // {E63232A0-9DBF-11d0-9CC1-00A0C905425E}
785     DEFINE_GUID(DPAID_INetW,
786     0xe63232a0, 0x9dbf, 0x11d0, 0x9c, 0xc1, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
787    
788     /*
789     * DPAID_InetPort
790     *
791     * Chunk is the port number used for creating the apps TCP and UDP sockets.
792     * WORD value (i.e. 47624).
793     */
794    
795     // {E4524541-8EA5-11d1-8A96-006097B01411}
796     DEFINE_GUID(DPAID_INetPort,
797     0xe4524541, 0x8ea5, 0x11d1, 0x8a, 0x96, 0x0, 0x60, 0x97, 0xb0, 0x14, 0x11);
798    
799     #ifdef BIGMESSAGEDEFENSE
800     #endif
801    
802     /*
803     * DPCOMPORTADDRESS
804     *
805     * Used to specify com port settings. The constants that define baud rate,
806     * stop bits and parity are defined in WINBASE.H. The constants for flow
807     * control are given below.
808     */
809    
810     #define DPCPA_NOFLOW 0 // no flow control
811     #define DPCPA_XONXOFFFLOW 1 // software flow control
812     #define DPCPA_RTSFLOW 2 // hardware flow control with RTS
813     #define DPCPA_DTRFLOW 3 // hardware flow control with DTR
814     #define DPCPA_RTSDTRFLOW 4 // hardware flow control with RTS and DTR
815    
816     typedef struct _DPCOMPORTADDRESS
817     {
818     DWORD dwComPort; // COM port to use (1-4)
819     DWORD dwBaudRate; // baud rate (100-256k)
820     DWORD dwStopBits; // no. stop bits (1-2)
821     DWORD dwParity; // parity (none, odd, even, mark)
822     DWORD dwFlowControl; // flow control (none, xon/xoff, rts, dtr)
823     } DPCOMPORTADDRESS;
824    
825     typedef DPCOMPORTADDRESS FAR *LPDPCOMPORTADDRESS;
826    
827     /*
828     * DPAID_ComPort
829     *
830     * Chunk contains a DPCOMPORTADDRESS structure defining the serial port.
831     */
832    
833     // {F2F0CE00-E0AF-11cf-9C4E-00A0C905425E}
834     DEFINE_GUID(DPAID_ComPort,
835     0xf2f0ce00, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
836    
837     /****************************************************************************
838     *
839     * dplobby 1.0 obsolete definitions
840     * Included for compatibility only.
841     *
842     ****************************************************************************/
843     #define DPLAD_SYSTEM DPLMSG_SYSTEM
844    
845    
846     #ifdef __cplusplus
847     };
848     #endif /* __cplusplus */
849    
850     #pragma warning(default:4201)
851    
852     #endif /* __DPLOBBY_INCLUDED__ */
853    

root@recompile.se
ViewVC Help
Powered by ViewVC 1.1.26