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

Contents of /api/include/dplay.h

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1.1.1.1 - (show annotations) (vendor branch)
Sun Jul 1 20:47:59 2001 UTC (22 years, 10 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 /*==========================================================================;
2 *
3 * Copyright (C) 1994-1997 Microsoft Corporation. All Rights Reserved.
4 *
5 * File: dplay.h
6 * Content: DirectPlay include file
7 *
8 ***************************************************************************/
9
10 #ifndef __DPLAY_INCLUDED__
11 #define __DPLAY_INCLUDED__
12
13 #include <ole2.h> // for DECLARE_INTERFACE and HRESULT
14
15 /* avoid warnings in MSVC at Level4 */
16 #pragma warning(disable:4201)
17
18
19 /*
20 * Some types
21 */
22
23 #ifndef _WIN64
24 #define DWORD_PTR DWORD
25 #endif
26
27 typedef LPVOID (*LPRGLPVOID)[];
28 typedef LPRGLPVOID PRGPVOID, LPRGPVOID, PRGLPVOID, PAPVOID, LPAPVOID, PALPVOID, LPALPVOID;
29
30 #define VOL volatile
31 typedef VOID *VOL LPVOIDV;
32
33
34 #define _FACDP 0x877
35 #define MAKE_DPHRESULT( code ) MAKE_HRESULT( 1, _FACDP, code )
36
37 #ifdef __cplusplus
38 extern "C" {
39 #endif
40
41 /*
42 * GUIDS used by DirectPlay objects
43 */
44 DEFINE_GUID(IID_IDirectPlay2, 0x2b74f7c0, 0x9154, 0x11cf, 0xa9, 0xcd, 0x0, 0xaa, 0x0, 0x68, 0x86, 0xe3);
45 DEFINE_GUID(IID_IDirectPlay2A,0x9d460580, 0xa822, 0x11cf, 0x96, 0xc, 0x0, 0x80, 0xc7, 0x53, 0x4e, 0x82);
46
47 DEFINE_GUID(IID_IDirectPlay3, 0x133efe40, 0x32dc, 0x11d0, 0x9c, 0xfb, 0x0, 0xa0, 0xc9, 0xa, 0x43, 0xcb);
48 DEFINE_GUID(IID_IDirectPlay3A,0x133efe41, 0x32dc, 0x11d0, 0x9c, 0xfb, 0x0, 0xa0, 0xc9, 0xa, 0x43, 0xcb);
49
50 DEFINE_GUID(IID_IDirectPlay4, 0xab1c530, 0x4745, 0x11d1, 0xa7, 0xa1, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
51 DEFINE_GUID(IID_IDirectPlay4A,0xab1c531, 0x4745, 0x11d1, 0xa7, 0xa1, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
52
53 // {D1EB6D20-8923-11d0-9D97-00A0C90A43CB}
54 DEFINE_GUID(CLSID_DirectPlay,0xd1eb6d20, 0x8923, 0x11d0, 0x9d, 0x97, 0x0, 0xa0, 0xc9, 0xa, 0x43, 0xcb);
55
56 /*
57 * GUIDS used by Service Providers shipped with DirectPlay
58 * Use these to identify Service Provider returned by EnumConnections
59 */
60
61 // GUID for IPX service provider
62 // {685BC400-9D2C-11cf-A9CD-00AA006886E3}
63 DEFINE_GUID(DPSPGUID_IPX,
64 0x685bc400, 0x9d2c, 0x11cf, 0xa9, 0xcd, 0x0, 0xaa, 0x0, 0x68, 0x86, 0xe3);
65
66 // GUID for TCP/IP service provider
67 // 36E95EE0-8577-11cf-960C-0080C7534E82
68 DEFINE_GUID(DPSPGUID_TCPIP,
69 0x36E95EE0, 0x8577, 0x11cf, 0x96, 0xc, 0x0, 0x80, 0xc7, 0x53, 0x4e, 0x82);
70
71 // GUID for Serial service provider
72 // {0F1D6860-88D9-11cf-9C4E-00A0C905425E}
73 DEFINE_GUID(DPSPGUID_SERIAL,
74 0xf1d6860, 0x88d9, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
75
76 // GUID for Modem service provider
77 // {44EAA760-CB68-11cf-9C4E-00A0C905425E}
78 DEFINE_GUID(DPSPGUID_MODEM,
79 0x44eaa760, 0xcb68, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
80
81 /****************************************************************************
82 *
83 * DirectPlay Structures
84 *
85 * Various structures used to invoke DirectPlay.
86 *
87 ****************************************************************************/
88
89 #ifndef IDIRECTPLAY2_OR_GREATER
90 typedef struct IDirectPlay FAR *LPDIRECTPLAY;
91 #else
92 typedef struct IUnknown FAR *LPDIRECTPLAY;
93 #endif
94
95 typedef struct IDirectPlay2 FAR *LPDIRECTPLAY2;
96 typedef struct IDirectPlay2 FAR *LPDIRECTPLAY2A;
97 typedef struct IDirectPlay2 IDirectPlay2A;
98
99 typedef struct IDirectPlay3 FAR *LPDIRECTPLAY3;
100 typedef struct IDirectPlay3 FAR *LPDIRECTPLAY3A;
101 typedef struct IDirectPlay3 IDirectPlay3A;
102
103 typedef struct IDirectPlay4 FAR *LPDIRECTPLAY4;
104 typedef struct IDirectPlay4 FAR *LPDIRECTPLAY4A;
105 typedef struct IDirectPlay4 IDirectPlay4A;
106
107 /*
108 * DPID
109 * DirectPlay player and group ID
110 */
111 typedef DWORD DPID, FAR *LPDPID;
112
113 /*
114 * DPID that system messages come from
115 */
116 #define DPID_SYSMSG 0
117
118 /*
119 * DPID representing all players in the session
120 */
121 #define DPID_ALLPLAYERS 0
122
123 /*
124 * DPID representing the server player
125 */
126 #define DPID_SERVERPLAYER 1
127
128
129 /*
130 * DPID representing the maxiumum ID in the range of DPID's reserved for
131 * use by DirectPlay.
132 */
133 #define DPID_RESERVEDRANGE 100
134
135 /*
136 * The player ID is unknown (used with e.g. DPSESSION_NOMESSAGEID)
137 */
138 #define DPID_UNKNOWN 0xFFFFFFFF
139
140 /*
141 * DPCAPS
142 * Used to obtain the capabilities of a DirectPlay object
143 */
144 typedef struct
145 {
146 DWORD dwSize; // Size of structure, in bytes
147 DWORD dwFlags; // DPCAPS_xxx flags
148 DWORD dwMaxBufferSize; // Maximum message size, in bytes, for this service provider
149 DWORD dwMaxQueueSize; // Obsolete.
150 DWORD dwMaxPlayers; // Maximum players/groups (local + remote)
151 DWORD dwHundredBaud; // Bandwidth in 100 bits per second units;
152 // i.e. 24 is 2400, 96 is 9600, etc.
153 DWORD dwLatency; // Estimated latency; 0 = unknown
154 DWORD dwMaxLocalPlayers; // Maximum # of locally created players allowed
155 DWORD dwHeaderLength; // Maximum header length, in bytes, on messages
156 // added by the service provider
157 DWORD dwTimeout; // Service provider's suggested timeout value
158 // This is how long DirectPlay will wait for
159 // responses to system messages
160 } DPCAPS, FAR *LPDPCAPS;
161
162 /*
163 * This DirectPlay object is the session host. If the host exits the
164 * session, another application will become the host and receive a
165 * DPSYS_HOST system message.
166 */
167 #define DPCAPS_ISHOST 0x00000002
168
169 /*
170 * The service provider bound to this DirectPlay object can optimize
171 * group messaging.
172 */
173 #define DPCAPS_GROUPOPTIMIZED 0x00000008
174
175 /*
176 * The service provider bound to this DirectPlay object can optimize
177 * keep alives (see DPSESSION_KEEPALIVE)
178 */
179 #define DPCAPS_KEEPALIVEOPTIMIZED 0x00000010
180
181 /*
182 * The service provider bound to this DirectPlay object can optimize
183 * guaranteed message delivery.
184 */
185 #define DPCAPS_GUARANTEEDOPTIMIZED 0x00000020
186
187 /*
188 * This DirectPlay object supports guaranteed message delivery.
189 */
190 #define DPCAPS_GUARANTEEDSUPPORTED 0x00000040
191
192 /*
193 * This DirectPlay object supports digital signing of messages.
194 */
195 #define DPCAPS_SIGNINGSUPPORTED 0x00000080
196
197 /*
198 * This DirectPlay object supports encryption of messages.
199 */
200 #define DPCAPS_ENCRYPTIONSUPPORTED 0x00000100
201
202 /*
203 * This DirectPlay player was created on this machine
204 */
205 #define DPPLAYERCAPS_LOCAL 0x00000800
206
207 /*
208 * Current Open settings supports all forms of Cancel
209 */
210 #define DPCAPS_ASYNCCANCELSUPPORTED 0x00001000
211
212 /*
213 * Current Open settings supports CancelAll, but not Cancel
214 */
215 #define DPCAPS_ASYNCCANCELALLSUPPORTED 0x00002000
216
217 /*
218 * Current Open settings supports Send Timeouts for sends
219 */
220 #define DPCAPS_SENDTIMEOUTSUPPORTED 0x00004000
221
222 /*
223 * Current Open settings supports send priority
224 */
225 #define DPCAPS_SENDPRIORITYSUPPORTED 0x00008000
226
227 /*
228 * Current Open settings supports DPSEND_ASYNC flag
229 */
230 #define DPCAPS_ASYNCSUPPORTED 0x00010000
231
232
233 /*
234 * DPSESSIONDESC2
235 * Used to describe the properties of a DirectPlay
236 * session instance
237 */
238 typedef struct
239 {
240 DWORD dwSize; // Size of structure
241 DWORD dwFlags; // DPSESSION_xxx flags
242 GUID guidInstance; // ID for the session instance
243 GUID guidApplication; // GUID of the DirectPlay application.
244 // GUID_NULL for all applications.
245 DWORD dwMaxPlayers; // Maximum # players allowed in session
246 DWORD dwCurrentPlayers; // Current # players in session (read only)
247 union
248 { // Name of the session
249 LPWSTR lpszSessionName; // Unicode
250 LPSTR lpszSessionNameA; // ANSI
251 };
252 union
253 { // Password of the session (optional)
254 LPWSTR lpszPassword; // Unicode
255 LPSTR lpszPasswordA; // ANSI
256 };
257 DWORD_PTR dwReserved1; // Reserved for future MS use.
258 DWORD_PTR dwReserved2;
259 DWORD_PTR dwUser1; // For use by the application
260 DWORD_PTR dwUser2;
261 DWORD_PTR dwUser3;
262 DWORD_PTR dwUser4;
263 } DPSESSIONDESC2, FAR *LPDPSESSIONDESC2;
264
265 typedef DPSESSIONDESC2 * VOL LPDPSESSIONDESC2_V;
266
267 /*
268 * LPCDPSESSIONDESC2
269 * A constant pointer to DPSESSIONDESC2
270 */
271 typedef const DPSESSIONDESC2 FAR *LPCDPSESSIONDESC2;
272
273 /*
274 * Applications cannot create new players in this session.
275 */
276 #define DPSESSION_NEWPLAYERSDISABLED 0x00000001
277
278 /*
279 * If the DirectPlay object that created the session, the host,
280 * quits, then the host will attempt to migrate to another
281 * DirectPlay object so that new players can continue to be created
282 * and new applications can join the session.
283 */
284 #define DPSESSION_MIGRATEHOST 0x00000004
285
286 /*
287 * This flag tells DirectPlay not to set the idPlayerTo and idPlayerFrom
288 * fields in player messages. This cuts two DWORD's off the message
289 * overhead.
290 */
291 #define DPSESSION_NOMESSAGEID 0x00000008
292
293
294 /*
295 * This flag tells DirectPlay to not allow any new applications to
296 * join the session. Applications already in the session can still
297 * create new players.
298 */
299 #define DPSESSION_JOINDISABLED 0x00000020
300
301 /*
302 * This flag tells DirectPlay to detect when remote players
303 * exit abnormally (e.g. their computer or modem gets unplugged)
304 */
305 #define DPSESSION_KEEPALIVE 0x00000040
306
307 /*
308 * This flag tells DirectPlay not to send a message to all players
309 * when a players remote data changes
310 */
311 #define DPSESSION_NODATAMESSAGES 0x00000080
312
313 /*
314 * This flag indicates that the session belongs to a secure server
315 * and needs user authentication
316 */
317 #define DPSESSION_SECURESERVER 0x00000100
318
319 /*
320 * This flag indicates that the session is private and requirs a password
321 * for EnumSessions as well as Open.
322 */
323 #define DPSESSION_PRIVATE 0x00000200
324
325 /*
326 * This flag indicates that the session requires a password for joining.
327 */
328 #define DPSESSION_PASSWORDREQUIRED 0x00000400
329
330 /*
331 * This flag tells DirectPlay to route all messages through the server
332 */
333 #define DPSESSION_MULTICASTSERVER 0x00000800
334
335 /*
336 * This flag tells DirectPlay to only download information about the
337 * DPPLAYER_SERVERPLAYER.
338 */
339 #define DPSESSION_CLIENTSERVER 0x00001000
340
341 /*
342 * This flag tells DirectPlay to use the protocol built into dplay
343 * for reliability and statistics all the time. When this bit is
344 * set, only other sessions with this bit set can join or be joined.
345 */
346 #define DPSESSION_DIRECTPLAYPROTOCOL 0x00002000
347
348 /*
349 * This flag tells DirectPlay that preserving order of received
350 * packets is not important, when using reliable delivery. This
351 * will allow messages to be indicated out of order if preceding
352 * messages have not yet arrived. Otherwise DPLAY will wait for
353 * earlier messages before delivering later reliable messages.
354 */
355 #define DPSESSION_NOPRESERVEORDER 0x00004000
356
357
358 /*
359 * This flag tells DirectPlay to optimize communication for latency
360 */
361 #define DPSESSION_OPTIMIZELATENCY 0x00008000
362
363 /*
364 * This flag allows lobby launched games that aren't voice enabled
365 * to get voice capabilities.
366 */
367 #define DPSESSION_ALLOWVOICERETRO 0x00010000
368
369 /*
370 * This flag supresses transmission of session desc changes.
371 * DPSESSION_NODATAMESSAGES was supposed to do that, but SetSessionDesc
372 * was ignoring the flag and some apps depended on the broken behavior, this
373 * flag allows applications to get the right behaviour without breaking apps depending
374 * on old broken behavior.
375 */
376 #define DPSESSION_NOSESSIONDESCMESSAGES 0x00020000
377
378 /*
379 * DPNAME
380 * Used to hold the name of a DirectPlay entity
381 * like a player or a group
382 */
383 typedef struct
384 {
385 DWORD dwSize; // Size of structure
386 DWORD dwFlags; // Not used. Must be zero.
387 union
388 { // The short or friendly name
389 LPWSTR lpszShortName; // Unicode
390 LPSTR lpszShortNameA; // ANSI
391 };
392 union
393 { // The long or formal name
394 LPWSTR lpszLongName; // Unicode
395 LPSTR lpszLongNameA; // ANSI
396 };
397
398 } DPNAME, FAR *LPDPNAME;
399
400 /*
401 * LPCDPNAME
402 * A constant pointer to DPNAME
403 */
404 typedef const DPNAME FAR *LPCDPNAME;
405
406 /*
407 * DPCREDENTIALS
408 * Used to hold the user name and password of a DirectPlay user
409 */
410 typedef struct
411 {
412 DWORD dwSize; // Size of structure
413 DWORD dwFlags; // Not used. Must be zero.
414 union
415 { // User name of the account
416 LPWSTR lpszUsername; // Unicode
417 LPSTR lpszUsernameA; // ANSI
418 };
419 union
420 { // Password of the account
421 LPWSTR lpszPassword; // Unicode
422 LPSTR lpszPasswordA; // ANSI
423 };
424 union
425 { // Domain name of the account
426 LPWSTR lpszDomain; // Unicode
427 LPSTR lpszDomainA; // ANSI
428 };
429 } DPCREDENTIALS, FAR *LPDPCREDENTIALS;
430
431 typedef const DPCREDENTIALS FAR *LPCDPCREDENTIALS;
432
433 /*
434 * DPSECURITYDESC
435 * Used to describe the security properties of a DirectPlay
436 * session instance
437 */
438 typedef struct
439 {
440 DWORD dwSize; // Size of structure
441 DWORD dwFlags; // Not used. Must be zero.
442 union
443 { // SSPI provider name
444 LPWSTR lpszSSPIProvider; // Unicode
445 LPSTR lpszSSPIProviderA; // ANSI
446 };
447 union
448 { // CAPI provider name
449 LPWSTR lpszCAPIProvider; // Unicode
450 LPSTR lpszCAPIProviderA; // ANSI
451 };
452 DWORD dwCAPIProviderType; // Crypto Service Provider type
453 DWORD dwEncryptionAlgorithm; // Encryption Algorithm type
454 } DPSECURITYDESC, FAR *LPDPSECURITYDESC;
455
456 typedef const DPSECURITYDESC FAR *LPCDPSECURITYDESC;
457
458 /*
459 * DPACCOUNTDESC
460 * Used to describe a user membership account
461 */
462 typedef struct
463 {
464 DWORD dwSize; // Size of structure
465 DWORD dwFlags; // Not used. Must be zero.
466 union
467 { // Account identifier
468 LPWSTR lpszAccountID; // Unicode
469 LPSTR lpszAccountIDA; // ANSI
470 };
471 } DPACCOUNTDESC, FAR *LPDPACCOUNTDESC;
472
473 typedef const DPACCOUNTDESC FAR *LPCDPACCOUNTDESC;
474
475 /*
476 * LPCGUID
477 * A constant pointer to a guid
478 */
479 typedef const GUID FAR *LPCGUID;
480
481 /*
482 * DPLCONNECTION
483 * Used to hold all in the informaion needed to connect
484 * an application to a session or create a session
485 */
486 typedef struct
487 {
488 DWORD dwSize; // Size of this structure
489 DWORD dwFlags; // Flags specific to this structure
490 LPDPSESSIONDESC2 lpSessionDesc; // Pointer to session desc to use on connect
491 LPDPNAME lpPlayerName; // Pointer to Player name structure
492 GUID guidSP; // GUID of the DPlay SP to use
493 LPVOID lpAddress; // Address for service provider
494 DWORD dwAddressSize; // Size of address data
495 } DPLCONNECTION, FAR *LPDPLCONNECTION;
496
497 /*
498 * LPCDPLCONNECTION
499 * A constant pointer to DPLCONNECTION
500 */
501 typedef const DPLCONNECTION FAR *LPCDPLCONNECTION;
502
503 /*
504 * DPCHAT
505 * Used to hold the a DirectPlay chat message
506 */
507 typedef struct
508 {
509 DWORD dwSize;
510 DWORD dwFlags;
511 union
512 { // Message string
513 LPWSTR lpszMessage; // Unicode
514 LPSTR lpszMessageA; // ANSI
515 };
516 } DPCHAT, FAR * LPDPCHAT;
517
518 /*
519 * SGBUFFER
520 * Scatter Gather Buffer used for SendEx
521 */
522 typedef struct
523 {
524 UINT len; // length of buffer data
525 PUCHAR pData; // pointer to buffer data
526 } SGBUFFER, *PSGBUFFER, FAR *LPSGBUFFER;
527
528
529 /****************************************************************************
530 *
531 * Prototypes for DirectPlay callback functions
532 *
533 ****************************************************************************/
534
535 /*
536 * Callback for IDirectPlay2::EnumSessions
537 */
538 typedef BOOL (FAR PASCAL * LPDPENUMSESSIONSCALLBACK2)(
539 LPCDPSESSIONDESC2 lpThisSD,
540 LPDWORD lpdwTimeOut,
541 DWORD dwFlags,
542 LPVOID lpContext );
543
544 /*
545 * This flag is set on the EnumSessions callback dwFlags parameter when
546 * the time out has occurred. There will be no session data for this
547 * callback. If *lpdwTimeOut is set to a non-zero value and the
548 * EnumSessionsCallback function returns TRUE then EnumSessions will
549 * continue waiting until the next timeout occurs. Timeouts are in
550 * milliseconds.
551 */
552 #define DPESC_TIMEDOUT 0x00000001
553
554
555 /*
556 * Callback for IDirectPlay2::EnumPlayers
557 * IDirectPlay2::EnumGroups
558 * IDirectPlay2::EnumGroupPlayers
559 */
560 typedef BOOL (FAR PASCAL *LPDPENUMPLAYERSCALLBACK2)(
561 DPID dpId,
562 DWORD dwPlayerType,
563 LPCDPNAME lpName,
564 DWORD dwFlags,
565 LPVOID lpContext );
566
567
568 /*
569 * Unicode callback for DirectPlayEnumerate
570 * This callback prototype will be used if compiling
571 * for Unicode strings
572 */
573 typedef BOOL (FAR PASCAL * LPDPENUMDPCALLBACK)(
574 LPGUID lpguidSP,
575 LPWSTR lpSPName,
576 DWORD dwMajorVersion,
577 DWORD dwMinorVersion,
578 LPVOID lpContext);
579
580 /*
581 * ANSI callback for DirectPlayEnumerate
582 * This callback prototype will be used if compiling
583 * for ANSI strings
584 */
585 typedef BOOL (FAR PASCAL * LPDPENUMDPCALLBACKA)(
586 LPGUID lpguidSP,
587 LPSTR lpSPName,
588 DWORD dwMajorVersion,
589 DWORD dwMinorVersion,
590 LPVOID lpContext);
591
592 /*
593 * Callback for IDirectPlay3(A)::EnumConnections
594 */
595 typedef BOOL (FAR PASCAL * LPDPENUMCONNECTIONSCALLBACK)(
596 LPCGUID lpguidSP,
597 LPVOID lpConnection,
598 DWORD dwConnectionSize,
599 LPCDPNAME lpName,
600 DWORD dwFlags,
601 LPVOID lpContext);
602
603
604 /*
605 * API's
606 */
607
608 #ifdef UNICODE
609 #define DirectPlayEnumerate DirectPlayEnumerateW
610 #else
611 #define DirectPlayEnumerate DirectPlayEnumerateA
612 #endif // UNICODE
613
614 extern HRESULT WINAPI DirectPlayEnumerateA( LPDPENUMDPCALLBACKA, LPVOID );
615 extern HRESULT WINAPI DirectPlayEnumerateW( LPDPENUMDPCALLBACK, LPVOID );
616 extern HRESULT WINAPI DirectPlayCreate( LPGUID lpGUID, LPDIRECTPLAY *lplpDP, IUnknown *pUnk);
617
618 /****************************************************************************
619 *
620 * IDirectPlay2 (and IDirectPlay2A) Interface
621 *
622 ****************************************************************************/
623
624 #undef INTERFACE
625 #define INTERFACE IDirectPlay2
626 DECLARE_INTERFACE_( IDirectPlay2, IUnknown )
627 {
628 /*** IUnknown methods ***/
629 STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
630 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
631 STDMETHOD_(ULONG,Release) (THIS) PURE;
632 /*** IDirectPlay2 methods ***/
633 STDMETHOD(AddPlayerToGroup) (THIS_ DPID, DPID) PURE;
634 STDMETHOD(Close) (THIS) PURE;
635 STDMETHOD(CreateGroup) (THIS_ LPDPID,LPDPNAME,LPVOID,DWORD,DWORD) PURE;
636 STDMETHOD(CreatePlayer) (THIS_ LPDPID,LPDPNAME,HANDLE,LPVOID,DWORD,DWORD) PURE;
637 STDMETHOD(DeletePlayerFromGroup)(THIS_ DPID,DPID) PURE;
638 STDMETHOD(DestroyGroup) (THIS_ DPID) PURE;
639 STDMETHOD(DestroyPlayer) (THIS_ DPID) PURE;
640 STDMETHOD(EnumGroupPlayers) (THIS_ DPID,LPGUID,LPDPENUMPLAYERSCALLBACK2,LPVOID,DWORD) PURE;
641 STDMETHOD(EnumGroups) (THIS_ LPGUID,LPDPENUMPLAYERSCALLBACK2,LPVOID,DWORD) PURE;
642 STDMETHOD(EnumPlayers) (THIS_ LPGUID,LPDPENUMPLAYERSCALLBACK2,LPVOID,DWORD) PURE;
643 STDMETHOD(EnumSessions) (THIS_ LPDPSESSIONDESC2,DWORD,LPDPENUMSESSIONSCALLBACK2,LPVOID,DWORD) PURE;
644 STDMETHOD(GetCaps) (THIS_ LPDPCAPS,DWORD) PURE;
645 STDMETHOD(GetGroupData) (THIS_ DPID,LPVOID,LPDWORD,DWORD) PURE;
646 STDMETHOD(GetGroupName) (THIS_ DPID,LPVOID,LPDWORD) PURE;
647 STDMETHOD(GetMessageCount) (THIS_ DPID, LPDWORD) PURE;
648 STDMETHOD(GetPlayerAddress) (THIS_ DPID,LPVOID,LPDWORD) PURE;
649 STDMETHOD(GetPlayerCaps) (THIS_ DPID,LPDPCAPS,DWORD) PURE;
650 STDMETHOD(GetPlayerData) (THIS_ DPID,LPVOID,LPDWORD,DWORD) PURE;
651 STDMETHOD(GetPlayerName) (THIS_ DPID,LPVOID,LPDWORD) PURE;
652 STDMETHOD(GetSessionDesc) (THIS_ LPVOID,LPDWORD) PURE;
653 STDMETHOD(Initialize) (THIS_ LPGUID) PURE;
654 STDMETHOD(Open) (THIS_ LPDPSESSIONDESC2,DWORD) PURE;
655 STDMETHOD(Receive) (THIS_ LPDPID,LPDPID,DWORD,LPVOID,LPDWORD) PURE;
656 STDMETHOD(Send) (THIS_ DPID, DPID, DWORD, LPVOID, DWORD) PURE;
657 STDMETHOD(SetGroupData) (THIS_ DPID,LPVOID,DWORD,DWORD) PURE;
658 STDMETHOD(SetGroupName) (THIS_ DPID,LPDPNAME,DWORD) PURE;
659 STDMETHOD(SetPlayerData) (THIS_ DPID,LPVOID,DWORD,DWORD) PURE;
660 STDMETHOD(SetPlayerName) (THIS_ DPID,LPDPNAME,DWORD) PURE;
661 STDMETHOD(SetSessionDesc) (THIS_ LPDPSESSIONDESC2,DWORD) PURE;
662 };
663
664 /****************************************************************************
665 *
666 * IDirectPlay2 interface macros
667 *
668 ****************************************************************************/
669
670 #if !defined(__cplusplus) || defined(CINTERFACE)
671
672 #define IDirectPlay2_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
673 #define IDirectPlay2_AddRef(p) (p)->lpVtbl->AddRef(p)
674 #define IDirectPlay2_Release(p) (p)->lpVtbl->Release(p)
675 #define IDirectPlay2_AddPlayerToGroup(p,a,b) (p)->lpVtbl->AddPlayerToGroup(p,a,b)
676 #define IDirectPlay2_Close(p) (p)->lpVtbl->Close(p)
677 #define IDirectPlay2_CreateGroup(p,a,b,c,d,e) (p)->lpVtbl->CreateGroup(p,a,b,c,d,e)
678 #define IDirectPlay2_CreatePlayer(p,a,b,c,d,e,f) (p)->lpVtbl->CreatePlayer(p,a,b,c,d,e,f)
679 #define IDirectPlay2_DeletePlayerFromGroup(p,a,b) (p)->lpVtbl->DeletePlayerFromGroup(p,a,b)
680 #define IDirectPlay2_DestroyGroup(p,a) (p)->lpVtbl->DestroyGroup(p,a)
681 #define IDirectPlay2_DestroyPlayer(p,a) (p)->lpVtbl->DestroyPlayer(p,a)
682 #define IDirectPlay2_EnumGroupPlayers(p,a,b,c,d,e) (p)->lpVtbl->EnumGroupPlayers(p,a,b,c,d,e)
683 #define IDirectPlay2_EnumGroups(p,a,b,c,d) (p)->lpVtbl->EnumGroups(p,a,b,c,d)
684 #define IDirectPlay2_EnumPlayers(p,a,b,c,d) (p)->lpVtbl->EnumPlayers(p,a,b,c,d)
685 #define IDirectPlay2_EnumSessions(p,a,b,c,d,e) (p)->lpVtbl->EnumSessions(p,a,b,c,d,e)
686 #define IDirectPlay2_GetCaps(p,a,b) (p)->lpVtbl->GetCaps(p,a,b)
687 #define IDirectPlay2_GetMessageCount(p,a,b) (p)->lpVtbl->GetMessageCount(p,a,b)
688 #define IDirectPlay2_GetGroupData(p,a,b,c,d) (p)->lpVtbl->GetGroupData(p,a,b,c,d)
689 #define IDirectPlay2_GetGroupName(p,a,b,c) (p)->lpVtbl->GetGroupName(p,a,b,c)
690 #define IDirectPlay2_GetPlayerAddress(p,a,b,c) (p)->lpVtbl->GetPlayerAddress(p,a,b,c)
691 #define IDirectPlay2_GetPlayerCaps(p,a,b,c) (p)->lpVtbl->GetPlayerCaps(p,a,b,c)
692 #define IDirectPlay2_GetPlayerData(p,a,b,c,d) (p)->lpVtbl->GetPlayerData(p,a,b,c,d)
693 #define IDirectPlay2_GetPlayerName(p,a,b,c) (p)->lpVtbl->GetPlayerName(p,a,b,c)
694 #define IDirectPlay2_GetSessionDesc(p,a,b) (p)->lpVtbl->GetSessionDesc(p,a,b)
695 #define IDirectPlay2_Initialize(p,a) (p)->lpVtbl->Initialize(p,a)
696 #define IDirectPlay2_Open(p,a,b) (p)->lpVtbl->Open(p,a,b)
697 #define IDirectPlay2_Receive(p,a,b,c,d,e) (p)->lpVtbl->Receive(p,a,b,c,d,e)
698 #define IDirectPlay2_Send(p,a,b,c,d,e) (p)->lpVtbl->Send(p,a,b,c,d,e)
699 #define IDirectPlay2_SetGroupData(p,a,b,c,d) (p)->lpVtbl->SetGroupData(p,a,b,c,d)
700 #define IDirectPlay2_SetGroupName(p,a,b,c) (p)->lpVtbl->SetGroupName(p,a,b,c)
701 #define IDirectPlay2_SetPlayerData(p,a,b,c,d) (p)->lpVtbl->SetPlayerData(p,a,b,c,d)
702 #define IDirectPlay2_SetPlayerName(p,a,b,c) (p)->lpVtbl->SetPlayerName(p,a,b,c)
703 #define IDirectPlay2_SetSessionDesc(p,a,b) (p)->lpVtbl->SetSessionDesc(p,a,b)
704
705 #else /* C++ */
706
707 #define IDirectPlay2_QueryInterface(p,a,b) (p)->QueryInterface(a,b)
708 #define IDirectPlay2_AddRef(p) (p)->AddRef()
709 #define IDirectPlay2_Release(p) (p)->Release()
710 #define IDirectPlay2_AddPlayerToGroup(p,a,b) (p)->AddPlayerToGroup(a,b)
711 #define IDirectPlay2_Close(p) (p)->Close()
712 #define IDirectPlay2_CreateGroup(p,a,b,c,d,e) (p)->CreateGroup(a,b,c,d,e)
713 #define IDirectPlay2_CreatePlayer(p,a,b,c,d,e,f) (p)->CreatePlayer(a,b,c,d,e,f)
714 #define IDirectPlay2_DeletePlayerFromGroup(p,a,b) (p)->DeletePlayerFromGroup(a,b)
715 #define IDirectPlay2_DestroyGroup(p,a) (p)->DestroyGroup(a)
716 #define IDirectPlay2_DestroyPlayer(p,a) (p)->DestroyPlayer(a)
717 #define IDirectPlay2_EnumGroupPlayers(p,a,b,c,d,e) (p)->EnumGroupPlayers(a,b,c,d,e)
718 #define IDirectPlay2_EnumGroups(p,a,b,c,d) (p)->EnumGroups(a,b,c,d)
719 #define IDirectPlay2_EnumPlayers(p,a,b,c,d) (p)->EnumPlayers(a,b,c,d)
720 #define IDirectPlay2_EnumSessions(p,a,b,c,d,e) (p)->EnumSessions(a,b,c,d,e)
721 #define IDirectPlay2_GetCaps(p,a,b) (p)->GetCaps(a,b)
722 #define IDirectPlay2_GetMessageCount(p,a,b) (p)->GetMessageCount(a,b)
723 #define IDirectPlay2_GetGroupData(p,a,b,c,d) (p)->GetGroupData(a,b,c,d)
724 #define IDirectPlay2_GetGroupName(p,a,b,c) (p)->GetGroupName(a,b,c)
725 #define IDirectPlay2_GetPlayerAddress(p,a,b,c) (p)->GetPlayerAddress(a,b,c)
726 #define IDirectPlay2_GetPlayerCaps(p,a,b,c) (p)->GetPlayerCaps(a,b,c)
727 #define IDirectPlay2_GetPlayerData(p,a,b,c,d) (p)->GetPlayerData(a,b,c,d)
728 #define IDirectPlay2_GetPlayerName(p,a,b,c) (p)->GetPlayerName(a,b,c)
729 #define IDirectPlay2_GetSessionDesc(p,a,b) (p)->GetSessionDesc(a,b)
730 #define IDirectPlay2_Initialize(p,a) (p)->Initialize(a)
731 #define IDirectPlay2_Open(p,a,b) (p)->Open(a,b)
732 #define IDirectPlay2_Receive(p,a,b,c,d,e) (p)->Receive(a,b,c,d,e)
733 #define IDirectPlay2_Send(p,a,b,c,d,e) (p)->Send(a,b,c,d,e)
734 #define IDirectPlay2_SetGroupData(p,a,b,c,d) (p)->SetGroupData(a,b,c,d)
735 #define IDirectPlay2_SetGroupName(p,a,b,c) (p)->SetGroupName(a,b,c)
736 #define IDirectPlay2_SetPlayerData(p,a,b,c,d) (p)->SetPlayerData(a,b,c,d)
737 #define IDirectPlay2_SetPlayerName(p,a,b,c) (p)->SetPlayerName(a,b,c)
738 #define IDirectPlay2_SetSessionDesc(p,a,b) (p)->SetSessionDesc(a,b)
739
740 #endif
741
742 /****************************************************************************
743 *
744 * IDirectPlay3 (and IDirectPlay3A) Interface
745 *
746 ****************************************************************************/
747
748 #undef INTERFACE
749 #define INTERFACE IDirectPlay3
750 DECLARE_INTERFACE_( IDirectPlay3, IDirectPlay2 )
751 {
752 /*** IUnknown methods ***/
753 STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
754 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
755 STDMETHOD_(ULONG,Release) (THIS) PURE;
756 /*** IDirectPlay2 methods ***/
757 STDMETHOD(AddPlayerToGroup) (THIS_ DPID, DPID) PURE;
758 STDMETHOD(Close) (THIS) PURE;
759 STDMETHOD(CreateGroup) (THIS_ LPDPID,LPDPNAME,LPVOID,DWORD,DWORD) PURE;
760 STDMETHOD(CreatePlayer) (THIS_ LPDPID,LPDPNAME,HANDLE,LPVOID,DWORD,DWORD) PURE;
761 STDMETHOD(DeletePlayerFromGroup)(THIS_ DPID,DPID) PURE;
762 STDMETHOD(DestroyGroup) (THIS_ DPID) PURE;
763 STDMETHOD(DestroyPlayer) (THIS_ DPID) PURE;
764 STDMETHOD(EnumGroupPlayers) (THIS_ DPID,LPGUID,LPDPENUMPLAYERSCALLBACK2,LPVOID,DWORD) PURE;
765 STDMETHOD(EnumGroups) (THIS_ LPGUID,LPDPENUMPLAYERSCALLBACK2,LPVOID,DWORD) PURE;
766 STDMETHOD(EnumPlayers) (THIS_ LPGUID,LPDPENUMPLAYERSCALLBACK2,LPVOID,DWORD) PURE;
767 STDMETHOD(EnumSessions) (THIS_ LPDPSESSIONDESC2,DWORD,LPDPENUMSESSIONSCALLBACK2,LPVOID,DWORD) PURE;
768 STDMETHOD(GetCaps) (THIS_ LPDPCAPS,DWORD) PURE;
769 STDMETHOD(GetGroupData) (THIS_ DPID,LPVOID,LPDWORD,DWORD) PURE;
770 STDMETHOD(GetGroupName) (THIS_ DPID,LPVOID,LPDWORD) PURE;
771 STDMETHOD(GetMessageCount) (THIS_ DPID, LPDWORD) PURE;
772 STDMETHOD(GetPlayerAddress) (THIS_ DPID,LPVOID,LPDWORD) PURE;
773 STDMETHOD(GetPlayerCaps) (THIS_ DPID,LPDPCAPS,DWORD) PURE;
774 STDMETHOD(GetPlayerData) (THIS_ DPID,LPVOID,LPDWORD,DWORD) PURE;
775 STDMETHOD(GetPlayerName) (THIS_ DPID,LPVOID,LPDWORD) PURE;
776 STDMETHOD(GetSessionDesc) (THIS_ LPVOID,LPDWORD) PURE;
777 STDMETHOD(Initialize) (THIS_ LPGUID) PURE;
778 STDMETHOD(Open) (THIS_ LPDPSESSIONDESC2,DWORD) PURE;
779 STDMETHOD(Receive) (THIS_ LPDPID,LPDPID,DWORD,LPVOID,LPDWORD) PURE;
780 STDMETHOD(Send) (THIS_ DPID, DPID, DWORD, LPVOID, DWORD) PURE;
781 STDMETHOD(SetGroupData) (THIS_ DPID,LPVOID,DWORD,DWORD) PURE;
782 STDMETHOD(SetGroupName) (THIS_ DPID,LPDPNAME,DWORD) PURE;
783 STDMETHOD(SetPlayerData) (THIS_ DPID,LPVOID,DWORD,DWORD) PURE;
784 STDMETHOD(SetPlayerName) (THIS_ DPID,LPDPNAME,DWORD) PURE;
785 STDMETHOD(SetSessionDesc) (THIS_ LPDPSESSIONDESC2,DWORD) PURE;
786 /*** IDirectPlay3 methods ***/
787 STDMETHOD(AddGroupToGroup) (THIS_ DPID, DPID) PURE;
788 STDMETHOD(CreateGroupInGroup) (THIS_ DPID,LPDPID,LPDPNAME,LPVOID,DWORD,DWORD) PURE;
789 STDMETHOD(DeleteGroupFromGroup) (THIS_ DPID,DPID) PURE;
790 STDMETHOD(EnumConnections) (THIS_ LPCGUID,LPDPENUMCONNECTIONSCALLBACK,LPVOID,DWORD) PURE;
791 STDMETHOD(EnumGroupsInGroup) (THIS_ DPID,LPGUID,LPDPENUMPLAYERSCALLBACK2,LPVOID,DWORD) PURE;
792 STDMETHOD(GetGroupConnectionSettings)(THIS_ DWORD, DPID, LPVOID, LPDWORD) PURE;
793 STDMETHOD(InitializeConnection) (THIS_ LPVOID,DWORD) PURE;
794 STDMETHOD(SecureOpen) (THIS_ LPCDPSESSIONDESC2,DWORD,LPCDPSECURITYDESC,LPCDPCREDENTIALS) PURE;
795 STDMETHOD(SendChatMessage) (THIS_ DPID,DPID,DWORD,LPDPCHAT) PURE;
796 STDMETHOD(SetGroupConnectionSettings)(THIS_ DWORD,DPID,LPDPLCONNECTION) PURE;
797 STDMETHOD(StartSession) (THIS_ DWORD,DPID) PURE;
798 STDMETHOD(GetGroupFlags) (THIS_ DPID,LPDWORD) PURE;
799 STDMETHOD(GetGroupParent) (THIS_ DPID,LPDPID) PURE;
800 STDMETHOD(GetPlayerAccount) (THIS_ DPID, DWORD, LPVOID, LPDWORD) PURE;
801 STDMETHOD(GetPlayerFlags) (THIS_ DPID,LPDWORD) PURE;
802 };
803
804 /****************************************************************************
805 *
806 * IDirectPlay3 interface macros
807 *
808 ****************************************************************************/
809
810 #if !defined(__cplusplus) || defined(CINTERFACE)
811
812 #define IDirectPlay3_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
813 #define IDirectPlay3_AddRef(p) (p)->lpVtbl->AddRef(p)
814 #define IDirectPlay3_Release(p) (p)->lpVtbl->Release(p)
815 #define IDirectPlay3_AddPlayerToGroup(p,a,b) (p)->lpVtbl->AddPlayerToGroup(p,a,b)
816 #define IDirectPlay3_Close(p) (p)->lpVtbl->Close(p)
817 #define IDirectPlay3_CreateGroup(p,a,b,c,d,e) (p)->lpVtbl->CreateGroup(p,a,b,c,d,e)
818 #define IDirectPlay3_CreatePlayer(p,a,b,c,d,e,f) (p)->lpVtbl->CreatePlayer(p,a,b,c,d,e,f)
819 #define IDirectPlay3_DeletePlayerFromGroup(p,a,b) (p)->lpVtbl->DeletePlayerFromGroup(p,a,b)
820 #define IDirectPlay3_DestroyGroup(p,a) (p)->lpVtbl->DestroyGroup(p,a)
821 #define IDirectPlay3_DestroyPlayer(p,a) (p)->lpVtbl->DestroyPlayer(p,a)
822 #define IDirectPlay3_EnumGroupPlayers(p,a,b,c,d,e) (p)->lpVtbl->EnumGroupPlayers(p,a,b,c,d,e)
823 #define IDirectPlay3_EnumGroups(p,a,b,c,d) (p)->lpVtbl->EnumGroups(p,a,b,c,d)
824 #define IDirectPlay3_EnumPlayers(p,a,b,c,d) (p)->lpVtbl->EnumPlayers(p,a,b,c,d)
825 #define IDirectPlay3_EnumSessions(p,a,b,c,d,e) (p)->lpVtbl->EnumSessions(p,a,b,c,d,e)
826 #define IDirectPlay3_GetCaps(p,a,b) (p)->lpVtbl->GetCaps(p,a,b)
827 #define IDirectPlay3_GetMessageCount(p,a,b) (p)->lpVtbl->GetMessageCount(p,a,b)
828 #define IDirectPlay3_GetGroupData(p,a,b,c,d) (p)->lpVtbl->GetGroupData(p,a,b,c,d)
829 #define IDirectPlay3_GetGroupName(p,a,b,c) (p)->lpVtbl->GetGroupName(p,a,b,c)
830 #define IDirectPlay3_GetPlayerAddress(p,a,b,c) (p)->lpVtbl->GetPlayerAddress(p,a,b,c)
831 #define IDirectPlay3_GetPlayerCaps(p,a,b,c) (p)->lpVtbl->GetPlayerCaps(p,a,b,c)
832 #define IDirectPlay3_GetPlayerData(p,a,b,c,d) (p)->lpVtbl->GetPlayerData(p,a,b,c,d)
833 #define IDirectPlay3_GetPlayerName(p,a,b,c) (p)->lpVtbl->GetPlayerName(p,a,b,c)
834 #define IDirectPlay3_GetSessionDesc(p,a,b) (p)->lpVtbl->GetSessionDesc(p,a,b)
835 #define IDirectPlay3_Initialize(p,a) (p)->lpVtbl->Initialize(p,a)
836 #define IDirectPlay3_Open(p,a,b) (p)->lpVtbl->Open(p,a,b)
837 #define IDirectPlay3_Receive(p,a,b,c,d,e) (p)->lpVtbl->Receive(p,a,b,c,d,e)
838 #define IDirectPlay3_Send(p,a,b,c,d,e) (p)->lpVtbl->Send(p,a,b,c,d,e)
839 #define IDirectPlay3_SetGroupData(p,a,b,c,d) (p)->lpVtbl->SetGroupData(p,a,b,c,d)
840 #define IDirectPlay3_SetGroupName(p,a,b,c) (p)->lpVtbl->SetGroupName(p,a,b,c)
841 #define IDirectPlay3_SetPlayerData(p,a,b,c,d) (p)->lpVtbl->SetPlayerData(p,a,b,c,d)
842 #define IDirectPlay3_SetPlayerName(p,a,b,c) (p)->lpVtbl->SetPlayerName(p,a,b,c)
843 #define IDirectPlay3_SetSessionDesc(p,a,b) (p)->lpVtbl->SetSessionDesc(p,a,b)
844 #define IDirectPlay3_AddGroupToGroup(p,a,b) (p)->lpVtbl->AddGroupToGroup(p,a,b)
845 #define IDirectPlay3_CreateGroupInGroup(p,a,b,c,d,e,f) (p)->lpVtbl->CreateGroupInGroup(p,a,b,c,d,e,f)
846 #define IDirectPlay3_DeleteGroupFromGroup(p,a,b) (p)->lpVtbl->DeleteGroupFromGroup(p,a,b)
847 #define IDirectPlay3_EnumConnections(p,a,b,c,d) (p)->lpVtbl->EnumConnections(p,a,b,c,d)
848 #define IDirectPlay3_EnumGroupsInGroup(p,a,b,c,d,e) (p)->lpVtbl->EnumGroupsInGroup(p,a,b,c,d,e)
849 #define IDirectPlay3_GetGroupConnectionSettings(p,a,b,c,d) (p)->lpVtbl->GetGroupConnectionSettings(p,a,b,c,d)
850 #define IDirectPlay3_InitializeConnection(p,a,b) (p)->lpVtbl->InitializeConnection(p,a,b)
851 #define IDirectPlay3_SecureOpen(p,a,b,c,d) (p)->lpVtbl->SecureOpen(p,a,b,c,d)
852 #define IDirectPlay3_SendChatMessage(p,a,b,c,d) (p)->lpVtbl->SendChatMessage(p,a,b,c,d)
853 #define IDirectPlay3_SetGroupConnectionSettings(p,a,b,c) (p)->lpVtbl->SetGroupConnectionSettings(p,a,b,c)
854 #define IDirectPlay3_StartSession(p,a,b) (p)->lpVtbl->StartSession(p,a,b)
855 #define IDirectPlay3_GetGroupFlags(p,a,b) (p)->lpVtbl->GetGroupFlags(p,a,b)
856 #define IDirectPlay3_GetGroupParent(p,a,b) (p)->lpVtbl->GetGroupParent(p,a,b)
857 #define IDirectPlay3_GetPlayerAccount(p,a,b,c,d) (p)->lpVtbl->GetPlayerAccount(p,a,b,c,d)
858 #define IDirectPlay3_GetPlayerFlags(p,a,b) (p)->lpVtbl->GetPlayerFlags(p,a,b)
859
860 #else /* C++ */
861
862 #define IDirectPlay3_QueryInterface(p,a,b) (p)->QueryInterface(a,b)
863 #define IDirectPlay3_AddRef(p) (p)->AddRef()
864 #define IDirectPlay3_Release(p) (p)->Release()
865 #define IDirectPlay3_AddPlayerToGroup(p,a,b) (p)->AddPlayerToGroup(a,b)
866 #define IDirectPlay3_Close(p) (p)->Close()
867 #define IDirectPlay3_CreateGroup(p,a,b,c,d,e) (p)->CreateGroup(a,b,c,d,e)
868 #define IDirectPlay3_CreatePlayer(p,a,b,c,d,e,f) (p)->CreatePlayer(a,b,c,d,e,f)
869 #define IDirectPlay3_DeletePlayerFromGroup(p,a,b) (p)->DeletePlayerFromGroup(a,b)
870 #define IDirectPlay3_DestroyGroup(p,a) (p)->DestroyGroup(a)
871 #define IDirectPlay3_DestroyPlayer(p,a) (p)->DestroyPlayer(a)
872 #define IDirectPlay3_EnumGroupPlayers(p,a,b,c,d,e) (p)->EnumGroupPlayers(a,b,c,d,e)
873 #define IDirectPlay3_EnumGroups(p,a,b,c,d) (p)->EnumGroups(a,b,c,d)
874 #define IDirectPlay3_EnumPlayers(p,a,b,c,d) (p)->EnumPlayers(a,b,c,d)
875 #define IDirectPlay3_EnumSessions(p,a,b,c,d,e) (p)->EnumSessions(a,b,c,d,e)
876 #define IDirectPlay3_GetCaps(p,a,b) (p)->GetCaps(a,b)
877 #define IDirectPlay3_GetMessageCount(p,a,b) (p)->GetMessageCount(a,b)
878 #define IDirectPlay3_GetGroupData(p,a,b,c,d) (p)->GetGroupData(a,b,c,d)
879 #define IDirectPlay3_GetGroupName(p,a,b,c) (p)->GetGroupName(a,b,c)
880 #define IDirectPlay3_GetPlayerAddress(p,a,b,c) (p)->GetPlayerAddress(a,b,c)
881 #define IDirectPlay3_GetPlayerCaps(p,a,b,c) (p)->GetPlayerCaps(a,b,c)
882 #define IDirectPlay3_GetPlayerData(p,a,b,c,d) (p)->GetPlayerData(a,b,c,d)
883 #define IDirectPlay3_GetPlayerName(p,a,b,c) (p)->GetPlayerName(a,b,c)
884 #define IDirectPlay3_GetSessionDesc(p,a,b) (p)->GetSessionDesc(a,b)
885 #define IDirectPlay3_Initialize(p,a) (p)->Initialize(a)
886 #define IDirectPlay3_Open(p,a,b) (p)->Open(a,b)
887 #define IDirectPlay3_Receive(p,a,b,c,d,e) (p)->Receive(a,b,c,d,e)
888 #define IDirectPlay3_Send(p,a,b,c,d,e) (p)->Send(a,b,c,d,e)
889 #define IDirectPlay3_SetGroupData(p,a,b,c,d) (p)->SetGroupData(a,b,c,d)
890 #define IDirectPlay3_SetGroupName(p,a,b,c) (p)->SetGroupName(a,b,c)
891 #define IDirectPlay3_SetPlayerData(p,a,b,c,d) (p)->SetPlayerData(a,b,c,d)
892 #define IDirectPlay3_SetPlayerName(p,a,b,c) (p)->SetPlayerName(a,b,c)
893 #define IDirectPlay3_SetSessionDesc(p,a,b) (p)->SetSessionDesc(a,b)
894 #define IDirectPlay3_AddGroupToGroup(p,a,b) (p)->AddGroupToGroup(a,b)
895 #define IDirectPlay3_CreateGroupInGroup(p,a,b,c,d,e,f) (p)->CreateGroupInGroup(a,b,c,d,e,f)
896 #define IDirectPlay3_DeleteGroupFromGroup(p,a,b) (p)->DeleteGroupFromGroup(a,b)
897 #define IDirectPlay3_EnumConnections(p,a,b,c,d) (p)->EnumConnections(a,b,c,d)
898 #define IDirectPlay3_EnumGroupsInGroup(p,a,b,c,d,e) (p)->EnumGroupsInGroup(a,b,c,d,e)
899 #define IDirectPlay3_GetGroupConnectionSettings(p,a,b,c,d) (p)->GetGroupConnectionSettings(a,b,c,d)
900 #define IDirectPlay3_InitializeConnection(p,a,b) (p)->InitializeConnection(a,b)
901 #define IDirectPlay3_SecureOpen(p,a,b,c,d) (p)->SecureOpen(a,b,c,d)
902 #define IDirectPlay3_SendChatMessage(p,a,b,c,d) (p)->SendChatMessage(a,b,c,d)
903 #define IDirectPlay3_SetGroupConnectionSettings(p,a,b,c) (p)->SetGroupConnectionSettings(a,b,c)
904 #define IDirectPlay3_StartSession(p,a,b) (p)->StartSession(a,b)
905 #define IDirectPlay3_GetGroupFlags(p,a,b) (p)->GetGroupFlags(a,b)
906 #define IDirectPlay3_GetGroupParent(p,a,b) (p)->GetGroupParent(a,b)
907 #define IDirectPlay3_GetPlayerAccount(p,a,b,c,d) (p)->GetPlayerAccount(a,b,c,d)
908 #define IDirectPlay3_GetPlayerFlags(p,a,b) (p)->GetPlayerFlags(a,b)
909
910 #endif
911
912 /****************************************************************************
913 *
914 * IDirectPlay4 (and IDirectPlay4A) Interface
915 *
916 ****************************************************************************/
917
918 #undef INTERFACE
919 #define INTERFACE IDirectPlay4
920 DECLARE_INTERFACE_( IDirectPlay4, IDirectPlay3 )
921 {
922 /*** IUnknown methods ***/
923 STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
924 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
925 STDMETHOD_(ULONG,Release) (THIS) PURE;
926 /*** IDirectPlay2 methods ***/
927 STDMETHOD(AddPlayerToGroup) (THIS_ DPID, DPID) PURE;
928 STDMETHOD(Close) (THIS) PURE;
929 STDMETHOD(CreateGroup) (THIS_ LPDPID,LPDPNAME,LPVOID,DWORD,DWORD) PURE;
930 STDMETHOD(CreatePlayer) (THIS_ LPDPID,LPDPNAME,HANDLE,LPVOID,DWORD,DWORD) PURE;
931 STDMETHOD(DeletePlayerFromGroup)(THIS_ DPID,DPID) PURE;
932 STDMETHOD(DestroyGroup) (THIS_ DPID) PURE;
933 STDMETHOD(DestroyPlayer) (THIS_ DPID) PURE;
934 STDMETHOD(EnumGroupPlayers) (THIS_ DPID,LPGUID,LPDPENUMPLAYERSCALLBACK2,LPVOID,DWORD) PURE;
935 STDMETHOD(EnumGroups) (THIS_ LPGUID,LPDPENUMPLAYERSCALLBACK2,LPVOID,DWORD) PURE;
936 STDMETHOD(EnumPlayers) (THIS_ LPGUID,LPDPENUMPLAYERSCALLBACK2,LPVOID,DWORD) PURE;
937 STDMETHOD(EnumSessions) (THIS_ LPDPSESSIONDESC2,DWORD,LPDPENUMSESSIONSCALLBACK2,LPVOID,DWORD) PURE;
938 STDMETHOD(GetCaps) (THIS_ LPDPCAPS,DWORD) PURE;
939 STDMETHOD(GetGroupData) (THIS_ DPID,LPVOID,LPDWORD,DWORD) PURE;
940 STDMETHOD(GetGroupName) (THIS_ DPID,LPVOID,LPDWORD) PURE;
941 STDMETHOD(GetMessageCount) (THIS_ DPID, LPDWORD) PURE;
942 STDMETHOD(GetPlayerAddress) (THIS_ DPID,LPVOID,LPDWORD) PURE;
943 STDMETHOD(GetPlayerCaps) (THIS_ DPID,LPDPCAPS,DWORD) PURE;
944 STDMETHOD(GetPlayerData) (THIS_ DPID,LPVOID,LPDWORD,DWORD) PURE;
945 STDMETHOD(GetPlayerName) (THIS_ DPID,LPVOID,LPDWORD) PURE;
946 STDMETHOD(GetSessionDesc) (THIS_ LPVOID,LPDWORD) PURE;
947 STDMETHOD(Initialize) (THIS_ LPGUID) PURE;
948 STDMETHOD(Open) (THIS_ LPDPSESSIONDESC2,DWORD) PURE;
949 STDMETHOD(Receive) (THIS_ LPDPID,LPDPID,DWORD,LPVOID,LPDWORD) PURE;
950 STDMETHOD(Send) (THIS_ DPID, DPID, DWORD, LPVOID, DWORD) PURE;
951 STDMETHOD(SetGroupData) (THIS_ DPID,LPVOID,DWORD,DWORD) PURE;
952 STDMETHOD(SetGroupName) (THIS_ DPID,LPDPNAME,DWORD) PURE;
953 STDMETHOD(SetPlayerData) (THIS_ DPID,LPVOID,DWORD,DWORD) PURE;
954 STDMETHOD(SetPlayerName) (THIS_ DPID,LPDPNAME,DWORD) PURE;
955 STDMETHOD(SetSessionDesc) (THIS_ LPDPSESSIONDESC2,DWORD) PURE;
956 /*** IDirectPlay3 methods ***/
957 STDMETHOD(AddGroupToGroup) (THIS_ DPID, DPID) PURE;
958 STDMETHOD(CreateGroupInGroup) (THIS_ DPID,LPDPID,LPDPNAME,LPVOID,DWORD,DWORD) PURE;
959 STDMETHOD(DeleteGroupFromGroup) (THIS_ DPID,DPID) PURE;
960 STDMETHOD(EnumConnections) (THIS_ LPCGUID,LPDPENUMCONNECTIONSCALLBACK,LPVOID,DWORD) PURE;
961 STDMETHOD(EnumGroupsInGroup) (THIS_ DPID,LPGUID,LPDPENUMPLAYERSCALLBACK2,LPVOID,DWORD) PURE;
962 STDMETHOD(GetGroupConnectionSettings)(THIS_ DWORD, DPID, LPVOID, LPDWORD) PURE;
963 STDMETHOD(InitializeConnection) (THIS_ LPVOID,DWORD) PURE;
964 STDMETHOD(SecureOpen) (THIS_ LPCDPSESSIONDESC2,DWORD,LPCDPSECURITYDESC,LPCDPCREDENTIALS) PURE;
965 STDMETHOD(SendChatMessage) (THIS_ DPID,DPID,DWORD,LPDPCHAT) PURE;
966 STDMETHOD(SetGroupConnectionSettings)(THIS_ DWORD,DPID,LPDPLCONNECTION) PURE;
967 STDMETHOD(StartSession) (THIS_ DWORD,DPID) PURE;
968 STDMETHOD(GetGroupFlags) (THIS_ DPID,LPDWORD) PURE;
969 STDMETHOD(GetGroupParent) (THIS_ DPID,LPDPID) PURE;
970 STDMETHOD(GetPlayerAccount) (THIS_ DPID, DWORD, LPVOID, LPDWORD) PURE;
971 STDMETHOD(GetPlayerFlags) (THIS_ DPID,LPDWORD) PURE;
972 /*** IDirectPlay4 methods ***/
973 STDMETHOD(GetGroupOwner) (THIS_ DPID, LPDPID) PURE;
974 STDMETHOD(SetGroupOwner) (THIS_ DPID, DPID) PURE;
975 STDMETHOD(SendEx) (THIS_ DPID, DPID, DWORD, LPVOID, DWORD, DWORD, DWORD, LPVOID, DWORD_PTR *) PURE;
976 STDMETHOD(GetMessageQueue) (THIS_ DPID, DPID, DWORD, LPDWORD, LPDWORD) PURE;
977 STDMETHOD(CancelMessage) (THIS_ DWORD, DWORD) PURE;
978 STDMETHOD(CancelPriority) (THIS_ DWORD, DWORD, DWORD) PURE;
979 };
980
981 /****************************************************************************
982 *
983 * IDirectPlayX interface macros (for IDirectPlay4 and beyond)
984 *
985 ****************************************************************************/
986
987 #if !defined(__cplusplus) || defined(CINTERFACE)
988
989 #define IDirectPlayX_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
990 #define IDirectPlayX_AddRef(p) (p)->lpVtbl->AddRef(p)
991 #define IDirectPlayX_Release(p) (p)->lpVtbl->Release(p)
992 #define IDirectPlayX_AddPlayerToGroup(p,a,b) (p)->lpVtbl->AddPlayerToGroup(p,a,b)
993 #define IDirectPlayX_CancelMessage(p,a,b) (p)->lpVtbl->CancelMessage(p,a,b)
994 #define IDirectPlayX_CancelPriority(p,a,b,c) (p)->lpVtbl->CancelPriority(p,a,b,c)
995 #define IDirectPlayX_Close(p) (p)->lpVtbl->Close(p)
996 #define IDirectPlayX_CreateGroup(p,a,b,c,d,e) (p)->lpVtbl->CreateGroup(p,a,b,c,d,e)
997 #define IDirectPlayX_CreatePlayer(p,a,b,c,d,e,f) (p)->lpVtbl->CreatePlayer(p,a,b,c,d,e,f)
998 #define IDirectPlayX_DeletePlayerFromGroup(p,a,b) (p)->lpVtbl->DeletePlayerFromGroup(p,a,b)
999 #define IDirectPlayX_DestroyGroup(p,a) (p)->lpVtbl->DestroyGroup(p,a)
1000 #define IDirectPlayX_DestroyPlayer(p,a) (p)->lpVtbl->DestroyPlayer(p,a)
1001 #define IDirectPlayX_EnumGroupPlayers(p,a,b,c,d,e) (p)->lpVtbl->EnumGroupPlayers(p,a,b,c,d,e)
1002 #define IDirectPlayX_EnumGroups(p,a,b,c,d) (p)->lpVtbl->EnumGroups(p,a,b,c,d)
1003 #define IDirectPlayX_EnumPlayers(p,a,b,c,d) (p)->lpVtbl->EnumPlayers(p,a,b,c,d)
1004 #define IDirectPlayX_EnumSessions(p,a,b,c,d,e) (p)->lpVtbl->EnumSessions(p,a,b,c,d,e)
1005 #define IDirectPlayX_GetCaps(p,a,b) (p)->lpVtbl->GetCaps(p,a,b)
1006 #define IDirectPlayX_GetMessageCount(p,a,b) (p)->lpVtbl->GetMessageCount(p,a,b)
1007 #define IDirectPlayX_GetMessageQueue(p,a,b,c,d,e) (p)->lpVtbl->GetMessageQueue(p,a,b,c,d,e)
1008 #define IDirectPlayX_GetGroupData(p,a,b,c,d) (p)->lpVtbl->GetGroupData(p,a,b,c,d)
1009 #define IDirectPlayX_GetGroupName(p,a,b,c) (p)->lpVtbl->GetGroupName(p,a,b,c)
1010 #define IDirectPlayX_GetPlayerAddress(p,a,b,c) (p)->lpVtbl->GetPlayerAddress(p,a,b,c)
1011 #define IDirectPlayX_GetPlayerCaps(p,a,b,c) (p)->lpVtbl->GetPlayerCaps(p,a,b,c)
1012 #define IDirectPlayX_GetPlayerData(p,a,b,c,d) (p)->lpVtbl->GetPlayerData(p,a,b,c,d)
1013 #define IDirectPlayX_GetPlayerName(p,a,b,c) (p)->lpVtbl->GetPlayerName(p,a,b,c)
1014 #define IDirectPlayX_GetSessionDesc(p,a,b) (p)->lpVtbl->GetSessionDesc(p,a,b)
1015 #define IDirectPlayX_Initialize(p,a) (p)->lpVtbl->Initialize(p,a)
1016 #define IDirectPlayX_Open(p,a,b) (p)->lpVtbl->Open(p,a,b)
1017 #define IDirectPlayX_Receive(p,a,b,c,d,e) (p)->lpVtbl->Receive(p,a,b,c,d,e)
1018 #define IDirectPlayX_Send(p,a,b,c,d,e) (p)->lpVtbl->Send(p,a,b,c,d,e)
1019 #define IDirectPlayX_SendEx(p,a,b,c,d,e,f,g,h,i) (p)->lpVtbl->SendEx(p,a,b,c,d,e,f,g,h,i)
1020 #define IDirectPlayX_SetGroupData(p,a,b,c,d) (p)->lpVtbl->SetGroupData(p,a,b,c,d)
1021 #define IDirectPlayX_SetGroupName(p,a,b,c) (p)->lpVtbl->SetGroupName(p,a,b,c)
1022 #define IDirectPlayX_SetPlayerData(p,a,b,c,d) (p)->lpVtbl->SetPlayerData(p,a,b,c,d)
1023 #define IDirectPlayX_SetPlayerName(p,a,b,c) (p)->lpVtbl->SetPlayerName(p,a,b,c)
1024 #define IDirectPlayX_SetSessionDesc(p,a,b) (p)->lpVtbl->SetSessionDesc(p,a,b)
1025 #define IDirectPlayX_AddGroupToGroup(p,a,b) (p)->lpVtbl->AddGroupToGroup(p,a,b)
1026 #define IDirectPlayX_CreateGroupInGroup(p,a,b,c,d,e,f) (p)->lpVtbl->CreateGroupInGroup(p,a,b,c,d,e,f)
1027 #define IDirectPlayX_DeleteGroupFromGroup(p,a,b) (p)->lpVtbl->DeleteGroupFromGroup(p,a,b)
1028 #define IDirectPlayX_EnumConnections(p,a,b,c,d) (p)->lpVtbl->EnumConnections(p,a,b,c,d)
1029 #define IDirectPlayX_EnumGroupsInGroup(p,a,b,c,d,e) (p)->lpVtbl->EnumGroupsInGroup(p,a,b,c,d,e)
1030 #define IDirectPlayX_GetGroupConnectionSettings(p,a,b,c,d) (p)->lpVtbl->GetGroupConnectionSettings(p,a,b,c,d)
1031 #define IDirectPlayX_InitializeConnection(p,a,b) (p)->lpVtbl->InitializeConnection(p,a,b)
1032 #define IDirectPlayX_SecureOpen(p,a,b,c,d) (p)->lpVtbl->SecureOpen(p,a,b,c,d)
1033 #define IDirectPlayX_SendChatMessage(p,a,b,c,d) (p)->lpVtbl->SendChatMessage(p,a,b,c,d)
1034 #define IDirectPlayX_SetGroupConnectionSettings(p,a,b,c) (p)->lpVtbl->SetGroupConnectionSettings(p,a,b,c)
1035 #define IDirectPlayX_StartSession(p,a,b) (p)->lpVtbl->StartSession(p,a,b)
1036 #define IDirectPlayX_GetGroupFlags(p,a,b) (p)->lpVtbl->GetGroupFlags(p,a,b)
1037 #define IDirectPlayX_GetGroupParent(p,a,b) (p)->lpVtbl->GetGroupParent(p,a,b)
1038 #define IDirectPlayX_GetPlayerAccount(p,a,b,c,d) (p)->lpVtbl->GetPlayerAccount(p,a,b,c,d)
1039 #define IDirectPlayX_GetPlayerFlags(p,a,b) (p)->lpVtbl->GetPlayerFlags(p,a,b)
1040 #define IDirectPlayX_GetGroupOwner(p,a,b) (p)->lpVtbl->GetGroupOwner(p,a,b)
1041 #define IDirectPlayX_SetGroupOwner(p,a,b) (p)->lpVtbl->SetGroupOwner(p,a,b)
1042
1043 #else /* C++ */
1044
1045 #define IDirectPlayX_QueryInterface(p,a,b) (p)->QueryInterface(a,b)
1046 #define IDirectPlayX_AddRef(p) (p)->AddRef()
1047 #define IDirectPlayX_Release(p) (p)->Release()
1048 #define IDirectPlayX_AddPlayerToGroup(p,a,b) (p)->AddPlayerToGroup(a,b)
1049 #define IDirectPlayX_CancelMessage(p,a,b) (p)->CancelMessage(a,b)
1050 #define IDirectPlayX_CancelPriority(p,a,b,c) (p)->CancelPriority(a,b,c)
1051 #define IDirectPlayX_Close(p) (p)->Close()
1052 #define IDirectPlayX_CreateGroup(p,a,b,c,d,e) (p)->CreateGroup(a,b,c,d,e)
1053 #define IDirectPlayX_CreatePlayer(p,a,b,c,d,e,f) (p)->CreatePlayer(a,b,c,d,e,f)
1054 #define IDirectPlayX_DeletePlayerFromGroup(p,a,b) (p)->DeletePlayerFromGroup(a,b)
1055 #define IDirectPlayX_DestroyGroup(p,a) (p)->DestroyGroup(a)
1056 #define IDirectPlayX_DestroyPlayer(p,a) (p)->DestroyPlayer(a)
1057 #define IDirectPlayX_EnumGroupPlayers(p,a,b,c,d,e) (p)->EnumGroupPlayers(a,b,c,d,e)
1058 #define IDirectPlayX_EnumGroups(p,a,b,c,d) (p)->EnumGroups(a,b,c,d)
1059 #define IDirectPlayX_EnumPlayers(p,a,b,c,d) (p)->EnumPlayers(a,b,c,d)
1060 #define IDirectPlayX_EnumSessions(p,a,b,c,d,e) (p)->EnumSessions(a,b,c,d,e)
1061 #define IDirectPlayX_GetCaps(p,a,b) (p)->GetCaps(a,b)
1062 #define IDirectPlayX_GetMessageCount(p,a,b) (p)->GetMessageCount(a,b)
1063 #define IDirectPlayX_GetMessageQueue(p,a,b,c,d,e) (p)->GetMessageQueue(a,b,c,d,e)
1064 #define IDirectPlayX_GetGroupData(p,a,b,c,d) (p)->GetGroupData(a,b,c,d)
1065 #define IDirectPlayX_GetGroupName(p,a,b,c) (p)->GetGroupName(a,b,c)
1066 #define IDirectPlayX_GetPlayerAddress(p,a,b,c) (p)->GetPlayerAddress(a,b,c)
1067 #define IDirectPlayX_GetPlayerCaps(p,a,b,c) (p)->GetPlayerCaps(a,b,c)
1068 #define IDirectPlayX_GetPlayerData(p,a,b,c,d) (p)->GetPlayerData(a,b,c,d)
1069 #define IDirectPlayX_GetPlayerName(p,a,b,c) (p)->GetPlayerName(a,b,c)
1070 #define IDirectPlayX_GetSessionDesc(p,a,b) (p)->GetSessionDesc(a,b)
1071 #define IDirectPlayX_Initialize(p,a) (p)->Initialize(a)
1072 #define IDirectPlayX_Open(p,a,b) (p)->Open(a,b)
1073 #define IDirectPlayX_Receive(p,a,b,c,d,e) (p)->Receive(a,b,c,d,e)
1074 #define IDirectPlayX_Send(p,a,b,c,d,e) (p)->Send(a,b,c,d,e)
1075 #define IDirectPlayX_SendEx(p,a,b,c,d,e,f,g,h,i) (p)->SendEx(a,b,c,d,e,f,g,h,i)
1076 #define IDirectPlayX_SetGroupData(p,a,b,c,d) (p)->SetGroupData(a,b,c,d)
1077 #define IDirectPlayX_SetGroupName(p,a,b,c) (p)->SetGroupName(a,b,c)
1078 #define IDirectPlayX_SetPlayerData(p,a,b,c,d) (p)->SetPlayerData(a,b,c,d)
1079 #define IDirectPlayX_SetPlayerName(p,a,b,c) (p)->SetPlayerName(a,b,c)
1080 #define IDirectPlayX_SetSessionDesc(p,a,b) (p)->SetSessionDesc(a,b)
1081 #define IDirectPlayX_AddGroupToGroup(p,a,b) (p)->AddGroupToGroup(a,b)
1082 #define IDirectPlayX_CreateGroupInGroup(p,a,b,c,d,e,f) (p)->CreateGroupInGroup(a,b,c,d,e,f)
1083 #define IDirectPlayX_DeleteGroupFromGroup(p,a,b) (p)->DeleteGroupFromGroup(a,b)
1084 #define IDirectPlayX_EnumConnections(p,a,b,c,d) (p)->EnumConnections(a,b,c,d)
1085 #define IDirectPlayX_EnumGroupsInGroup(p,a,b,c,d,e) (p)->EnumGroupsInGroup(a,b,c,d,e)
1086 #define IDirectPlayX_GetGroupConnectionSettings(p,a,b,c,d) (p)->GetGroupConnectionSettings(a,b,c,d)
1087 #define IDirectPlayX_InitializeConnection(p,a,b) (p)->InitializeConnection(a,b)
1088 #define IDirectPlayX_SecureOpen(p,a,b,c,d) (p)->SecureOpen(a,b,c,d)
1089 #define IDirectPlayX_SendChatMessage(p,a,b,c,d) (p)->SendChatMessage(a,b,c,d)
1090 #define IDirectPlayX_SetGroupConnectionSettings(p,a,b,c) (p)->SetGroupConnectionSettings(a,b,c)
1091 #define IDirectPlayX_StartSession(p,a,b) (p)->StartSession(a,b)
1092 #define IDirectPlayX_GetGroupFlags(p,a,b) (p)->GetGroupFlags(a,b)
1093 #define IDirectPlayX_GetGroupParent(p,a,b) (p)->GetGroupParent(a,b)
1094 #define IDirectPlayX_GetPlayerAccount(p,a,b,c,d) (p)->GetPlayerAccount(a,b,c,d)
1095 #define IDirectPlayX_GetPlayerFlags(p,a,b) (p)->GetPlayerFlags(a,b)
1096 #define IDirectPlayX_GetGroupOwner(p,a,b) (p)->GetGroupOwner(a,b)
1097 #define IDirectPlayX_SetGroupOwner(p,a,b) (p)->SetGroupOwner(a,b)
1098
1099 #endif
1100
1101 /****************************************************************************
1102 *
1103 * EnumConnections API flags
1104 *
1105 ****************************************************************************/
1106
1107 /*
1108 * Enumerate Service Providers
1109 */
1110 #define DPCONNECTION_DIRECTPLAY 0x00000001
1111
1112 /*
1113 * Enumerate Lobby Providers
1114 */
1115 #define DPCONNECTION_DIRECTPLAYLOBBY 0x00000002
1116
1117
1118 /****************************************************************************
1119 *
1120 * EnumPlayers API flags
1121 *
1122 ****************************************************************************/
1123
1124 /*
1125 * Enumerate all players in the current session
1126 */
1127 #define DPENUMPLAYERS_ALL 0x00000000
1128 #define DPENUMGROUPS_ALL DPENUMPLAYERS_ALL
1129
1130
1131 /*
1132 * Enumerate only local (created by this application) players
1133 * or groups
1134 */
1135 #define DPENUMPLAYERS_LOCAL 0x00000008
1136 #define DPENUMGROUPS_LOCAL DPENUMPLAYERS_LOCAL
1137
1138 /*
1139 * Enumerate only remote (non-local) players
1140 * or groups
1141 */
1142 #define DPENUMPLAYERS_REMOTE 0x00000010
1143 #define DPENUMGROUPS_REMOTE DPENUMPLAYERS_REMOTE
1144
1145 /*
1146 * Enumerate groups along with the players
1147 */
1148 #define DPENUMPLAYERS_GROUP 0x00000020
1149
1150 /*
1151 * Enumerate players or groups in another session
1152 * (must supply lpguidInstance)
1153 */
1154 #define DPENUMPLAYERS_SESSION 0x00000080
1155 #define DPENUMGROUPS_SESSION DPENUMPLAYERS_SESSION
1156
1157 /*
1158 * Enumerate server players
1159 */
1160 #define DPENUMPLAYERS_SERVERPLAYER 0x00000100
1161
1162 /*
1163 * Enumerate spectator players
1164 */
1165 #define DPENUMPLAYERS_SPECTATOR 0x00000200
1166
1167 /*
1168 * Enumerate shortcut groups
1169 */
1170 #define DPENUMGROUPS_SHORTCUT 0x00000400
1171
1172 /*
1173 * Enumerate staging area groups
1174 */
1175 #define DPENUMGROUPS_STAGINGAREA 0x00000800
1176
1177 /*
1178 * Enumerate hidden groups
1179 */
1180 #define DPENUMGROUPS_HIDDEN 0x00001000
1181
1182 /*
1183 * Enumerate the group's owner
1184 */
1185 #define DPENUMPLAYERS_OWNER 0x00002000
1186
1187
1188 /****************************************************************************
1189 *
1190 * CreatePlayer API flags
1191 *
1192 ****************************************************************************/
1193
1194 /*
1195 * This flag indicates that this player should be designated
1196 * the server player. The app should specify this at CreatePlayer.
1197 */
1198 #define DPPLAYER_SERVERPLAYER DPENUMPLAYERS_SERVERPLAYER
1199
1200 /*
1201 * This flag indicates that this player should be designated
1202 * a spectator. The app should specify this at CreatePlayer.
1203 */
1204 #define DPPLAYER_SPECTATOR DPENUMPLAYERS_SPECTATOR
1205
1206 /*
1207 * This flag indicates that this player was created locally.
1208 * (returned from GetPlayerFlags)
1209 */
1210 #define DPPLAYER_LOCAL DPENUMPLAYERS_LOCAL
1211
1212 /*
1213 * This flag indicates that this player is the group's owner
1214 * (Only returned in EnumGroupPlayers)
1215 */
1216 #define DPPLAYER_OWNER DPENUMPLAYERS_OWNER
1217
1218 /****************************************************************************
1219 *
1220 * CreateGroup API flags
1221 *
1222 ****************************************************************************/
1223
1224
1225 /*
1226 * This flag indicates that the StartSession can be called on the group.
1227 * The app should specify this at CreateGroup, or CreateGroupInGroup.
1228 */
1229 #define DPGROUP_STAGINGAREA DPENUMGROUPS_STAGINGAREA
1230
1231 /*
1232 * This flag indicates that this group was created locally.
1233 * (returned from GetGroupFlags)
1234 */
1235 #define DPGROUP_LOCAL DPENUMGROUPS_LOCAL
1236
1237 /*
1238 * This flag indicates that this group was created hidden.
1239 */
1240 #define DPGROUP_HIDDEN DPENUMGROUPS_HIDDEN
1241
1242
1243 /****************************************************************************
1244 *
1245 * EnumSessions API flags
1246 *
1247 ****************************************************************************/
1248
1249 /*
1250 * Enumerate sessions which can be joined
1251 */
1252 #define DPENUMSESSIONS_AVAILABLE 0x00000001
1253
1254 /*
1255 * Enumerate all sessions even if they can't be joined.
1256 */
1257 #define DPENUMSESSIONS_ALL 0x00000002
1258
1259
1260 /*
1261 * Start an asynchronous enum sessions
1262 */
1263 #define DPENUMSESSIONS_ASYNC 0x00000010
1264
1265 /*
1266 * Stop an asynchronous enum sessions
1267 */
1268 #define DPENUMSESSIONS_STOPASYNC 0x00000020
1269
1270 /*
1271 * Enumerate sessions even if they require a password
1272 */
1273 #define DPENUMSESSIONS_PASSWORDREQUIRED 0x00000040
1274
1275 /*
1276 * Return status about progress of enumeration instead of
1277 * showing any status dialogs.
1278 */
1279 #define DPENUMSESSIONS_RETURNSTATUS 0x00000080
1280
1281 /****************************************************************************
1282 *
1283 * GetCaps and GetPlayerCaps API flags
1284 *
1285 ****************************************************************************/
1286
1287 /*
1288 * The latency returned should be for guaranteed message sending.
1289 * Default is non-guaranteed messaging.
1290 */
1291 #define DPGETCAPS_GUARANTEED 0x00000001
1292
1293
1294 /****************************************************************************
1295 *
1296 * GetGroupData, GetPlayerData API flags
1297 * Remote and local Group/Player data is maintained separately.
1298 * Default is DPGET_REMOTE.
1299 *
1300 ****************************************************************************/
1301
1302 /*
1303 * Get the remote data (set by any DirectPlay object in
1304 * the session using DPSET_REMOTE)
1305 */
1306 #define DPGET_REMOTE 0x00000000
1307
1308 /*
1309 * Get the local data (set by this DirectPlay object
1310 * using DPSET_LOCAL)
1311 */
1312 #define DPGET_LOCAL 0x00000001
1313
1314
1315 /****************************************************************************
1316 *
1317 * Open API flags
1318 *
1319 ****************************************************************************/
1320
1321 /*
1322 * Join the session that is described by the DPSESSIONDESC2 structure
1323 */
1324 #define DPOPEN_JOIN 0x00000001
1325
1326 /*
1327 * Create a new session as described by the DPSESSIONDESC2 structure
1328 */
1329 #define DPOPEN_CREATE 0x00000002
1330
1331 /*
1332 * Return status about progress of open instead of showing
1333 * any status dialogs.
1334 */
1335 #define DPOPEN_RETURNSTATUS DPENUMSESSIONS_RETURNSTATUS
1336
1337
1338 /****************************************************************************
1339 *
1340 * DPLCONNECTION flags
1341 *
1342 ****************************************************************************/
1343
1344 /*
1345 * This application should create a new session as
1346 * described by the DPSESIONDESC structure
1347 */
1348 #define DPLCONNECTION_CREATESESSION DPOPEN_CREATE
1349
1350 /*
1351 * This application should join the session described by
1352 * the DPSESIONDESC structure with the lpAddress data
1353 */
1354 #define DPLCONNECTION_JOINSESSION DPOPEN_JOIN
1355
1356 /****************************************************************************
1357 *
1358 * Receive API flags
1359 * Default is DPRECEIVE_ALL
1360 *
1361 ****************************************************************************/
1362
1363 /*
1364 * Get the first message in the queue
1365 */
1366 #define DPRECEIVE_ALL 0x00000001
1367
1368 /*
1369 * Get the first message in the queue directed to a specific player
1370 */
1371 #define DPRECEIVE_TOPLAYER 0x00000002
1372
1373 /*
1374 * Get the first message in the queue from a specific player
1375 */
1376 #define DPRECEIVE_FROMPLAYER 0x00000004
1377
1378 /*
1379 * Get the message but don't remove it from the queue
1380 */
1381 #define DPRECEIVE_PEEK 0x00000008
1382
1383
1384 /****************************************************************************
1385 *
1386 * Send API flags
1387 *
1388 ****************************************************************************/
1389
1390 /*
1391 * Send the message using a guaranteed send method.
1392 * Default is non-guaranteed.
1393 */
1394 #define DPSEND_GUARANTEED 0x00000001
1395
1396
1397 /*
1398 * This flag is obsolete. It is ignored by DirectPlay
1399 */
1400 #define DPSEND_HIGHPRIORITY 0x00000002
1401
1402 /*
1403 * This flag is obsolete. It is ignored by DirectPlay
1404 */
1405 #define DPSEND_OPENSTREAM 0x00000008
1406
1407 /*
1408 * This flag is obsolete. It is ignored by DirectPlay
1409 */
1410 #define DPSEND_CLOSESTREAM 0x00000010
1411
1412 /*
1413 * Send the message digitally signed to ensure authenticity.
1414 */
1415 #define DPSEND_SIGNED 0x00000020
1416
1417 /*
1418 * Send the message with encryption to ensure privacy.
1419 */
1420 #define DPSEND_ENCRYPTED 0x00000040
1421
1422 /*
1423 * The message is a lobby system message
1424 */
1425 #define DPSEND_LOBBYSYSTEMMESSAGE 0x00000080
1426
1427
1428 /*
1429 * Send message asynchronously, must check caps
1430 * before using this flag. It is always provided
1431 * if the protocol flag is set.
1432 */
1433 #define DPSEND_ASYNC 0x00000200
1434
1435 /*
1436 * When an message is completed, don't tell me.
1437 * by default the application is notified with a system message.
1438 */
1439 #define DPSEND_NOSENDCOMPLETEMSG 0x00000400
1440
1441
1442 /*
1443 * Maximum priority for sends available to applications
1444 */
1445 #define DPSEND_MAX_PRI 0x0000FFFF
1446 #define DPSEND_MAX_PRIORITY DPSEND_MAX_PRI
1447
1448
1449 /****************************************************************************
1450 *
1451 * SetGroupData, SetGroupName, SetPlayerData, SetPlayerName,
1452 * SetSessionDesc API flags.
1453 * Default is DPSET_REMOTE.
1454 *
1455 ****************************************************************************/
1456
1457 /*
1458 * Propagate the data to all players in the session
1459 */
1460 #define DPSET_REMOTE 0x00000000
1461
1462 /*
1463 * Do not propagate the data to other players
1464 */
1465 #define DPSET_LOCAL 0x00000001
1466
1467 /*
1468 * Used with DPSET_REMOTE, use guaranteed message send to
1469 * propagate the data
1470 */
1471 #define DPSET_GUARANTEED 0x00000002
1472
1473 /****************************************************************************
1474 *
1475 * GetMessageQueue API flags.
1476 * Default is DPMESSAGEQUEUE_SEND
1477 *
1478 ****************************************************************************/
1479
1480 /*
1481 * Get Send Queue - requires Service Provider Support
1482 */
1483 #define DPMESSAGEQUEUE_SEND 0x00000001
1484
1485 /*
1486 * Get Receive Queue
1487 */
1488 #define DPMESSAGEQUEUE_RECEIVE 0x00000002
1489
1490
1491 /****************************************************************************
1492 *
1493 * Connect API flags
1494 *
1495 ****************************************************************************/
1496
1497
1498 /*
1499 * Start an asynchronous connect which returns status codes
1500 */
1501 #define DPCONNECT_RETURNSTATUS (DPENUMSESSIONS_RETURNSTATUS)
1502
1503
1504 /****************************************************************************
1505 *
1506 * DirectPlay system messages and message data structures
1507 *
1508 * All system message come 'From' player DPID_SYSMSG. To determine what type
1509 * of message it is, cast the lpData from Receive to DPMSG_GENERIC and check
1510 * the dwType member against one of the following DPSYS_xxx constants. Once
1511 * a match is found, cast the lpData to the corresponding of the DPMSG_xxx
1512 * structures to access the data of the message.
1513 *
1514 ****************************************************************************/
1515
1516 /*
1517 * A new player or group has been created in the session
1518 * Use DPMSG_CREATEPLAYERORGROUP. Check dwPlayerType to see if it
1519 * is a player or a group.
1520 */
1521 #define DPSYS_CREATEPLAYERORGROUP 0x0003
1522
1523 /*
1524 * A player has been deleted from the session
1525 * Use DPMSG_DESTROYPLAYERORGROUP
1526 */
1527 #define DPSYS_DESTROYPLAYERORGROUP 0x0005
1528
1529 /*
1530 * A player has been added to a group
1531 * Use DPMSG_ADDPLAYERTOGROUP
1532 */
1533 #define DPSYS_ADDPLAYERTOGROUP 0x0007
1534
1535 /*
1536 * A player has been removed from a group
1537 * Use DPMSG_DELETEPLAYERFROMGROUP
1538 */
1539 #define DPSYS_DELETEPLAYERFROMGROUP 0x0021
1540
1541 /*
1542 * This DirectPlay object lost its connection with all the
1543 * other players in the session.
1544 * Use DPMSG_SESSIONLOST.
1545 */
1546 #define DPSYS_SESSIONLOST 0x0031
1547
1548 /*
1549 * The current host has left the session.
1550 * This DirectPlay object is now the host.
1551 * Use DPMSG_HOST.
1552 */
1553 #define DPSYS_HOST 0x0101
1554
1555 /*
1556 * The remote data associated with a player or
1557 * group has changed. Check dwPlayerType to see
1558 * if it is a player or a group
1559 * Use DPMSG_SETPLAYERORGROUPDATA
1560 */
1561 #define DPSYS_SETPLAYERORGROUPDATA 0x0102
1562
1563 /*
1564 * The name of a player or group has changed.
1565 * Check dwPlayerType to see if it is a player
1566 * or a group.
1567 * Use DPMSG_SETPLAYERORGROUPNAME
1568 */
1569 #define DPSYS_SETPLAYERORGROUPNAME 0x0103
1570
1571 /*
1572 * The session description has changed.
1573 * Use DPMSG_SETSESSIONDESC
1574 */
1575 #define DPSYS_SETSESSIONDESC 0x0104
1576
1577 /*
1578 * A group has been added to a group
1579 * Use DPMSG_ADDGROUPTOGROUP
1580 */
1581 #define DPSYS_ADDGROUPTOGROUP 0x0105
1582
1583 /*
1584 * A group has been removed from a group
1585 * Use DPMSG_DELETEGROUPFROMGROUP
1586 */
1587 #define DPSYS_DELETEGROUPFROMGROUP 0x0106
1588
1589 /*
1590 * A secure player-player message has arrived.
1591 * Use DPMSG_SECUREMESSAGE
1592 */
1593 #define DPSYS_SECUREMESSAGE 0x0107
1594
1595 /*
1596 * Start a new session.
1597 * Use DPMSG_STARTSESSION
1598 */
1599 #define DPSYS_STARTSESSION 0x0108
1600
1601 /*
1602 * A chat message has arrived
1603 * Use DPMSG_CHAT
1604 */
1605 #define DPSYS_CHAT 0x0109
1606
1607 /*
1608 * The owner of a group has changed
1609 * Use DPMSG_SETGROUPOWNER
1610 */
1611 #define DPSYS_SETGROUPOWNER 0x010A
1612
1613 /*
1614 * An async send has finished, failed or been cancelled
1615 * Use DPMSG_SENDCOMPLETE
1616 */
1617 #define DPSYS_SENDCOMPLETE 0x010d
1618
1619
1620 /*
1621 * Used in the dwPlayerType field to indicate if it applies to a group
1622 * or a player
1623 */
1624 #define DPPLAYERTYPE_GROUP 0x00000000
1625 #define DPPLAYERTYPE_PLAYER 0x00000001
1626
1627
1628 /*
1629 * DPMSG_GENERIC
1630 * Generic message structure used to identify the message type.
1631 */
1632 typedef struct
1633 {
1634 DWORD dwType; // Message type
1635 } DPMSG_GENERIC, FAR *LPDPMSG_GENERIC;
1636
1637 /*
1638 * DPMSG_CREATEPLAYERORGROUP
1639 * System message generated when a new player or group
1640 * created in the session with information about it.
1641 */
1642 typedef struct
1643 {
1644 DWORD dwType; // Message type
1645 DWORD dwPlayerType; // Is it a player or group
1646 DPID dpId; // ID of the player or group
1647 DWORD dwCurrentPlayers; // current # players & groups in session
1648 LPVOID lpData; // pointer to remote data
1649 DWORD dwDataSize; // size of remote data
1650 DPNAME dpnName; // structure with name info
1651 // the following fields are only available when using
1652 // the IDirectPlay3 interface or greater
1653 DPID dpIdParent; // id of parent group
1654 DWORD dwFlags; // player or group flags
1655 } DPMSG_CREATEPLAYERORGROUP, FAR *LPDPMSG_CREATEPLAYERORGROUP;
1656
1657 /*
1658 * DPMSG_DESTROYPLAYERORGROUP
1659 * System message generated when a player or group is being
1660 * destroyed in the session with information about it.
1661 */
1662 typedef struct
1663 {
1664 DWORD dwType; // Message type
1665 DWORD dwPlayerType; // Is it a player or group
1666 DPID dpId; // player ID being deleted
1667 LPVOID lpLocalData; // copy of players local data
1668 DWORD dwLocalDataSize; // sizeof local data
1669 LPVOID lpRemoteData; // copy of players remote data
1670 DWORD dwRemoteDataSize; // sizeof remote data
1671 // the following fields are only available when using
1672 // the IDirectPlay3 interface or greater
1673 DPNAME dpnName; // structure with name info
1674 DPID dpIdParent; // id of parent group
1675 DWORD dwFlags; // player or group flags
1676 } DPMSG_DESTROYPLAYERORGROUP, FAR *LPDPMSG_DESTROYPLAYERORGROUP;
1677
1678 /*
1679 * DPMSG_ADDPLAYERTOGROUP
1680 * System message generated when a player is being added
1681 * to a group.
1682 */
1683 typedef struct
1684 {
1685 DWORD dwType; // Message type
1686 DPID dpIdGroup; // group ID being added to
1687 DPID dpIdPlayer; // player ID being added
1688 } DPMSG_ADDPLAYERTOGROUP, FAR *LPDPMSG_ADDPLAYERTOGROUP;
1689
1690 /*
1691 * DPMSG_DELETEPLAYERFROMGROUP
1692 * System message generated when a player is being
1693 * removed from a group
1694 */
1695 typedef DPMSG_ADDPLAYERTOGROUP DPMSG_DELETEPLAYERFROMGROUP;
1696 typedef DPMSG_DELETEPLAYERFROMGROUP FAR *LPDPMSG_DELETEPLAYERFROMGROUP;
1697
1698 /*
1699 * DPMSG_ADDGROUPTOGROUP
1700 * System message generated when a group is being added
1701 * to a group.
1702 */
1703 typedef struct
1704 {
1705 DWORD dwType; // Message type
1706 DPID dpIdParentGroup; // group ID being added to
1707 DPID dpIdGroup; // group ID being added
1708 } DPMSG_ADDGROUPTOGROUP, FAR *LPDPMSG_ADDGROUPTOGROUP;
1709
1710 /*
1711 * DPMSG_DELETEGROUPFROMGROUP
1712 * System message generated when a GROUP is being
1713 * removed from a group
1714 */
1715 typedef DPMSG_ADDGROUPTOGROUP DPMSG_DELETEGROUPFROMGROUP;
1716 typedef DPMSG_DELETEGROUPFROMGROUP FAR *LPDPMSG_DELETEGROUPFROMGROUP;
1717
1718 /*
1719 * DPMSG_SETPLAYERORGROUPDATA
1720 * System message generated when remote data for a player or
1721 * group has changed.
1722 */
1723 typedef struct
1724 {
1725 DWORD dwType; // Message type
1726 DWORD dwPlayerType; // Is it a player or group
1727 DPID dpId; // ID of player or group
1728 LPVOID lpData; // pointer to remote data
1729 DWORD dwDataSize; // size of remote data
1730 } DPMSG_SETPLAYERORGROUPDATA, FAR *LPDPMSG_SETPLAYERORGROUPDATA;
1731
1732 /*
1733 * DPMSG_SETPLAYERORGROUPNAME
1734 * System message generated when the name of a player or
1735 * group has changed.
1736 */
1737 typedef struct
1738 {
1739 DWORD dwType; // Message type
1740 DWORD dwPlayerType; // Is it a player or group
1741 DPID dpId; // ID of player or group
1742 DPNAME dpnName; // structure with new name info
1743 } DPMSG_SETPLAYERORGROUPNAME, FAR *LPDPMSG_SETPLAYERORGROUPNAME;
1744
1745 /*
1746 * DPMSG_SETSESSIONDESC
1747 * System message generated when session desc has changed
1748 */
1749 typedef struct
1750 {
1751 DWORD dwType; // Message type
1752 DPSESSIONDESC2 dpDesc; // Session desc
1753 } DPMSG_SETSESSIONDESC, FAR *LPDPMSG_SETSESSIONDESC;
1754
1755 /*
1756 * DPMSG_HOST
1757 * System message generated when the host has migrated to this
1758 * DirectPlay object.
1759 *
1760 */
1761 typedef DPMSG_GENERIC DPMSG_HOST;
1762 typedef DPMSG_HOST FAR *LPDPMSG_HOST;
1763
1764 /*
1765 * DPMSG_SESSIONLOST
1766 * System message generated when the connection to the session is lost.
1767 *
1768 */
1769 typedef DPMSG_GENERIC DPMSG_SESSIONLOST;
1770 typedef DPMSG_SESSIONLOST FAR *LPDPMSG_SESSIONLOST;
1771
1772 /*
1773 * DPMSG_SECUREMESSAGE
1774 * System message generated when a player requests a secure send
1775 */
1776 typedef struct
1777 {
1778 DWORD dwType; // Message Type
1779 DWORD dwFlags; // Signed/Encrypted
1780 DPID dpIdFrom; // ID of Sending Player
1781 LPVOID lpData; // Player message
1782 DWORD dwDataSize; // Size of player message
1783 } DPMSG_SECUREMESSAGE, FAR *LPDPMSG_SECUREMESSAGE;
1784
1785 /*
1786 * DPMSG_STARTSESSION
1787 * System message containing all information required to
1788 * start a new session
1789 */
1790 typedef struct
1791 {
1792 DWORD dwType; // Message type
1793 LPDPLCONNECTION lpConn; // DPLCONNECTION structure
1794 } DPMSG_STARTSESSION, FAR *LPDPMSG_STARTSESSION;
1795
1796 /*
1797 * DPMSG_CHAT
1798 * System message containing a chat message
1799 */
1800 typedef struct
1801 {
1802 DWORD dwType; // Message type
1803 DWORD dwFlags; // Message flags
1804 DPID idFromPlayer; // ID of the Sending Player
1805 DPID idToPlayer; // ID of the To Player
1806 DPID idToGroup; // ID of the To Group
1807 LPDPCHAT lpChat; // Pointer to a structure containing the chat message
1808 } DPMSG_CHAT, FAR *LPDPMSG_CHAT;
1809
1810 /*
1811 * DPMSG_SETGROUPOWNER
1812 * System message generated when the owner of a group has changed
1813 */
1814 typedef struct
1815 {
1816 DWORD dwType; // Message type
1817 DPID idGroup; // ID of the group
1818 DPID idNewOwner; // ID of the player that is the new owner
1819 DPID idOldOwner; // ID of the player that used to be the owner
1820 } DPMSG_SETGROUPOWNER, FAR *LPDPMSG_SETGROUPOWNER;
1821
1822 /*
1823 * DPMSG_SENDCOMPLETE
1824 * System message generated when finished with an Async Send message
1825 *
1826 * NOTE SENDPARMS has an overlay for DPMSG_SENDCOMPLETE, don't
1827 * change this message w/o changing SENDPARMS.
1828 */
1829 typedef struct
1830 {
1831 DWORD dwType;
1832 DPID idFrom;
1833 DPID idTo;
1834 DWORD dwFlags;
1835 DWORD dwPriority;
1836 DWORD dwTimeout;
1837 LPVOID lpvContext;
1838 DWORD dwMsgID;
1839 HRESULT hr;
1840 DWORD dwSendTime;
1841 } DPMSG_SENDCOMPLETE, *LPDPMSG_SENDCOMPLETE;
1842
1843 /****************************************************************************
1844 *
1845 * DIRECTPLAY ERRORS
1846 *
1847 * Errors are represented by negative values and cannot be combined.
1848 *
1849 ****************************************************************************/
1850 #define DP_OK S_OK
1851 #define DPERR_ALREADYINITIALIZED MAKE_DPHRESULT( 5 )
1852 #define DPERR_ACCESSDENIED MAKE_DPHRESULT( 10 )
1853 #define DPERR_ACTIVEPLAYERS MAKE_DPHRESULT( 20 )
1854 #define DPERR_BUFFERTOOSMALL MAKE_DPHRESULT( 30 )
1855 #define DPERR_CANTADDPLAYER MAKE_DPHRESULT( 40 )
1856 #define DPERR_CANTCREATEGROUP MAKE_DPHRESULT( 50 )
1857 #define DPERR_CANTCREATEPLAYER MAKE_DPHRESULT( 60 )
1858 #define DPERR_CANTCREATESESSION MAKE_DPHRESULT( 70 )
1859 #define DPERR_CAPSNOTAVAILABLEYET MAKE_DPHRESULT( 80 )
1860 #define DPERR_EXCEPTION MAKE_DPHRESULT( 90 )
1861 #define DPERR_GENERIC E_FAIL
1862 #define DPERR_INVALIDFLAGS MAKE_DPHRESULT( 120 )
1863 #define DPERR_INVALIDOBJECT MAKE_DPHRESULT( 130 )
1864 #define DPERR_INVALIDPARAM E_INVALIDARG
1865 #define DPERR_INVALIDPARAMS DPERR_INVALIDPARAM
1866 #define DPERR_INVALIDPLAYER MAKE_DPHRESULT( 150 )
1867 #define DPERR_INVALIDGROUP MAKE_DPHRESULT( 155 )
1868 #define DPERR_NOCAPS MAKE_DPHRESULT( 160 )
1869 #define DPERR_NOCONNECTION MAKE_DPHRESULT( 170 )
1870 #define DPERR_NOMEMORY E_OUTOFMEMORY
1871 #define DPERR_OUTOFMEMORY DPERR_NOMEMORY
1872 #define DPERR_NOMESSAGES MAKE_DPHRESULT( 190 )
1873 #define DPERR_NONAMESERVERFOUND MAKE_DPHRESULT( 200 )
1874 #define DPERR_NOPLAYERS MAKE_DPHRESULT( 210 )
1875 #define DPERR_NOSESSIONS MAKE_DPHRESULT( 220 )
1876 #define DPERR_PENDING E_PENDING
1877 #define DPERR_SENDTOOBIG MAKE_DPHRESULT( 230 )
1878 #define DPERR_TIMEOUT MAKE_DPHRESULT( 240 )
1879 #define DPERR_UNAVAILABLE MAKE_DPHRESULT( 250 )
1880 #define DPERR_UNSUPPORTED E_NOTIMPL
1881 #define DPERR_BUSY MAKE_DPHRESULT( 270 )
1882 #define DPERR_USERCANCEL MAKE_DPHRESULT( 280 )
1883 #define DPERR_NOINTERFACE E_NOINTERFACE
1884 #define DPERR_CANNOTCREATESERVER MAKE_DPHRESULT( 290 )
1885 #define DPERR_PLAYERLOST MAKE_DPHRESULT( 300 )
1886 #define DPERR_SESSIONLOST MAKE_DPHRESULT( 310 )
1887 #define DPERR_UNINITIALIZED MAKE_DPHRESULT( 320 )
1888 #define DPERR_NONEWPLAYERS MAKE_DPHRESULT( 330 )
1889 #define DPERR_INVALIDPASSWORD MAKE_DPHRESULT( 340 )
1890 #define DPERR_CONNECTING MAKE_DPHRESULT( 350 )
1891 #define DPERR_CONNECTIONLOST MAKE_DPHRESULT( 360 )
1892 #define DPERR_UNKNOWNMESSAGE MAKE_DPHRESULT( 370 )
1893 #define DPERR_CANCELFAILED MAKE_DPHRESULT( 380 )
1894 #define DPERR_INVALIDPRIORITY MAKE_DPHRESULT( 390 )
1895 #define DPERR_NOTHANDLED MAKE_DPHRESULT( 400 )
1896 #define DPERR_CANCELLED MAKE_DPHRESULT( 410 )
1897 #define DPERR_ABORTED MAKE_DPHRESULT( 420 )
1898
1899
1900 #define DPERR_BUFFERTOOLARGE MAKE_DPHRESULT( 1000 )
1901 #define DPERR_CANTCREATEPROCESS MAKE_DPHRESULT( 1010 )
1902 #define DPERR_APPNOTSTARTED MAKE_DPHRESULT( 1020 )
1903 #define DPERR_INVALIDINTERFACE MAKE_DPHRESULT( 1030 )
1904 #define DPERR_NOSERVICEPROVIDER MAKE_DPHRESULT( 1040 )
1905 #define DPERR_UNKNOWNAPPLICATION MAKE_DPHRESULT( 1050 )
1906 #define DPERR_NOTLOBBIED MAKE_DPHRESULT( 1070 )
1907 #define DPERR_SERVICEPROVIDERLOADED MAKE_DPHRESULT( 1080 )
1908 #define DPERR_ALREADYREGISTERED MAKE_DPHRESULT( 1090 )
1909 #define DPERR_NOTREGISTERED MAKE_DPHRESULT( 1100 )
1910
1911 //
1912 // Security related errors
1913 //
1914 #define DPERR_AUTHENTICATIONFAILED MAKE_DPHRESULT( 2000 )
1915 #define DPERR_CANTLOADSSPI MAKE_DPHRESULT( 2010 )
1916 #define DPERR_ENCRYPTIONFAILED MAKE_DPHRESULT( 2020 )
1917 #define DPERR_SIGNFAILED MAKE_DPHRESULT( 2030 )
1918 #define DPERR_CANTLOADSECURITYPACKAGE MAKE_DPHRESULT( 2040 )
1919 #define DPERR_ENCRYPTIONNOTSUPPORTED MAKE_DPHRESULT( 2050 )
1920 #define DPERR_CANTLOADCAPI MAKE_DPHRESULT( 2060 )
1921 #define DPERR_NOTLOGGEDIN MAKE_DPHRESULT( 2070 )
1922 #define DPERR_LOGONDENIED MAKE_DPHRESULT( 2080 )
1923
1924
1925 /****************************************************************************
1926 *
1927 * dplay 1.0 obsolete structures + interfaces
1928 * Included for compatibility only. New apps should
1929 * use IDirectPlay2
1930 *
1931 ****************************************************************************/
1932
1933 // define this to ignore obsolete interfaces and constants
1934 #ifndef IDIRECTPLAY2_OR_GREATER
1935
1936 #define DPOPEN_OPENSESSION DPOPEN_JOIN
1937 #define DPOPEN_CREATESESSION DPOPEN_CREATE
1938
1939 #define DPENUMSESSIONS_PREVIOUS 0x00000004
1940
1941 #define DPENUMPLAYERS_PREVIOUS 0x00000004
1942
1943 #define DPSEND_GUARANTEE DPSEND_GUARANTEED
1944 #define DPSEND_TRYONCE 0x00000004
1945
1946 #define DPCAPS_NAMESERVICE 0x00000001
1947 #define DPCAPS_NAMESERVER DPCAPS_ISHOST
1948 #define DPCAPS_GUARANTEED 0x00000004
1949
1950 #define DPLONGNAMELEN 52
1951 #define DPSHORTNAMELEN 20
1952 #define DPSESSIONNAMELEN 32
1953 #define DPPASSWORDLEN 16
1954 #define DPUSERRESERVED 16
1955
1956 #define DPSYS_ADDPLAYER 0x0003
1957 #define DPSYS_DELETEPLAYER 0x0005
1958
1959 #define DPSYS_DELETEGROUP 0x0020
1960 #define DPSYS_DELETEPLAYERFROMGRP 0x0021
1961 #define DPSYS_CONNECT 0x484b
1962
1963 typedef struct
1964 {
1965 DWORD dwType;
1966 DWORD dwPlayerType;
1967 DPID dpId;
1968 char szLongName[DPLONGNAMELEN];
1969 char szShortName[DPSHORTNAMELEN];
1970 DWORD dwCurrentPlayers;
1971 } DPMSG_ADDPLAYER;
1972
1973 typedef DPMSG_ADDPLAYER DPMSG_ADDGROUP;
1974
1975 typedef struct
1976 {
1977 DWORD dwType;
1978 DPID dpIdGroup;
1979 DPID dpIdPlayer;
1980 } DPMSG_GROUPADD;
1981
1982 typedef DPMSG_GROUPADD DPMSG_GROUPDELETE;
1983 typedef struct
1984 {
1985 DWORD dwType;
1986 DPID dpId;
1987 } DPMSG_DELETEPLAYER;
1988
1989 typedef BOOL (PASCAL *LPDPENUMPLAYERSCALLBACK)(
1990 DPID dpId,
1991 LPSTR lpFriendlyName,
1992 LPSTR lpFormalName,
1993 DWORD dwFlags,
1994 LPVOID lpContext );
1995
1996 typedef struct
1997 {
1998 DWORD dwSize;
1999 GUID guidSession;
2000 DWORD_PTR dwSession;
2001 DWORD dwMaxPlayers;
2002 DWORD dwCurrentPlayers;
2003 DWORD dwFlags;
2004 char szSessionName[DPSESSIONNAMELEN];
2005 char szUserField[DPUSERRESERVED];
2006 DWORD_PTR dwReserved1;
2007 char szPassword[DPPASSWORDLEN];
2008 DWORD_PTR dwReserved2;
2009 DWORD_PTR dwUser1;
2010 DWORD_PTR dwUser2;
2011 DWORD_PTR dwUser3;
2012 DWORD_PTR dwUser4;
2013 } DPSESSIONDESC,*LPDPSESSIONDESC;
2014
2015 typedef BOOL (PASCAL * LPDPENUMSESSIONSCALLBACK)(
2016 LPDPSESSIONDESC lpDPSessionDesc,
2017 LPVOID lpContext,
2018 LPDWORD lpdwTimeOut,
2019 DWORD dwFlags);
2020
2021 /*
2022 * IDirectPlay
2023 */
2024 #undef INTERFACE
2025 #define INTERFACE IDirectPlay
2026 DECLARE_INTERFACE_( IDirectPlay, IUnknown )
2027 {
2028 /*** IUnknown methods ***/
2029 STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
2030 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
2031 STDMETHOD_(ULONG,Release) (THIS) PURE;
2032 /*** IDirectPlay methods ***/
2033 STDMETHOD(AddPlayerToGroup) (THIS_ DPID, DPID) PURE;
2034 STDMETHOD(Close) (THIS) PURE;
2035 STDMETHOD(CreatePlayer) (THIS_ LPDPID,LPSTR,LPSTR,LPHANDLE) PURE;
2036 STDMETHOD(CreateGroup) (THIS_ LPDPID,LPSTR,LPSTR) PURE;
2037 STDMETHOD(DeletePlayerFromGroup)(THIS_ DPID,DPID) PURE;
2038 STDMETHOD(DestroyPlayer) (THIS_ DPID) PURE;
2039 STDMETHOD(DestroyGroup) (THIS_ DPID) PURE;
2040 STDMETHOD(EnableNewPlayers) (THIS_ BOOL) PURE;
2041 STDMETHOD(EnumGroupPlayers) (THIS_ DPID, LPDPENUMPLAYERSCALLBACK,LPVOID,DWORD) PURE;
2042 STDMETHOD(EnumGroups) (THIS_ DWORD, LPDPENUMPLAYERSCALLBACK,LPVOID,DWORD) PURE;
2043 STDMETHOD(EnumPlayers) (THIS_ DWORD, LPDPENUMPLAYERSCALLBACK,LPVOID,DWORD) PURE;
2044 STDMETHOD(EnumSessions) (THIS_ LPDPSESSIONDESC,DWORD,LPDPENUMSESSIONSCALLBACK,LPVOID,DWORD) PURE;
2045 STDMETHOD(GetCaps) (THIS_ LPDPCAPS) PURE;
2046 STDMETHOD(GetMessageCount) (THIS_ DPID, LPDWORD) PURE;
2047 STDMETHOD(GetPlayerCaps) (THIS_ DPID, LPDPCAPS) PURE;
2048 STDMETHOD(GetPlayerName) (THIS_ DPID,LPSTR,LPDWORD,LPSTR,LPDWORD) PURE;
2049 STDMETHOD(Initialize) (THIS_ LPGUID) PURE;
2050 STDMETHOD(Open) (THIS_ LPDPSESSIONDESC) PURE;
2051 STDMETHOD(Receive) (THIS_ LPDPID,LPDPID,DWORD,LPVOID,LPDWORD) PURE;
2052 STDMETHOD(SaveSession) (THIS_ LPSTR) PURE;
2053 STDMETHOD(Send) (THIS_ DPID, DPID, DWORD, LPVOID, DWORD) PURE;
2054 STDMETHOD(SetPlayerName) (THIS_ DPID,LPSTR,LPSTR) PURE;
2055 };
2056
2057 /****************************************************************************
2058 *
2059 * IDirectPlay interface macros
2060 *
2061 ****************************************************************************/
2062
2063 #if !defined(__cplusplus) || defined(CINTERFACE)
2064
2065 #define IDirectPlay_AddPlayerToGroup(p,a,b) (p)->lpVtbl->AddPlayerToGroup(p,a,b)
2066 #define IDirectPlay_Close(p) (p)->lpVtbl->Close(p)
2067 #define IDirectPlay_CreateGroup(p,a,b,c) (p)->lpVtbl->CreateGroup(p,a,b,c)
2068 #define IDirectPlay_CreatePlayer(p,a,b,c,d) (p)->lpVtbl->CreatePlayer(p,a,b,c,d)
2069 #define IDirectPlay_DeletePlayerFromGroup(p,a,b) (p)->lpVtbl->DeletePlayerFromGroup(p,a,b)
2070 #define IDirectPlay_DestroyGroup(p,a) (p)->lpVtbl->DestroyGroup(p,a)
2071 #define IDirectPlay_DestroyPlayer(p,a) (p)->lpVtbl->DestroyPlayer(p,a)
2072 #define IDirectPlay_EnableNewPlayers(p,a) (p)->lpVtbl->EnableNewPlayers(p,a)
2073 #define IDirectPlay_EnumGroupPlayers(p,a,b,c,d) (p)->lpVtbl->EnumGroupPlayers(p,a,b,c,d)
2074 #define IDirectPlay_EnumGroups(p,a,b,c,d) (p)->lpVtbl->EnumGroups(p,a,b,c,d)
2075 #define IDirectPlay_EnumPlayers(p,a,b,c,d) (p)->lpVtbl->EnumPlayers(p,a,b,c,d)
2076 #define IDirectPlay_EnumSessions(p,a,b,c,d,e) (p)->lpVtbl->EnumSessions(p,a,b,c,d,e)
2077 #define IDirectPlay_GetCaps(p,a) (p)->lpVtbl->GetCaps(p,a)
2078 #define IDirectPlay_GetMessageCount(p,a,b) (p)->lpVtbl->GetMessageCount(p,a,b)
2079 #define IDirectPlay_GetPlayerCaps(p,a,b) (p)->lpVtbl->GetPlayerCaps(p,a,b)
2080 #define IDirectPlay_GetPlayerName(p,a,b,c,d,e) (p)->lpVtbl->GetPlayerName(p,a,b,c,d,e)
2081 #define IDirectPlay_Initialize(p,a) (p)->lpVtbl->Initialize(p,a)
2082 #define IDirectPlay_Open(p,a) (p)->lpVtbl->Open(p,a)
2083 #define IDirectPlay_Receive(p,a,b,c,d,e) (p)->lpVtbl->Receive(p,a,b,c,d,e)
2084 #define IDirectPlay_SaveSession(p,a) (p)->lpVtbl->SaveSession(p,a)
2085 #define IDirectPlay_Send(p,a,b,c,d,e) (p)->lpVtbl->Send(p,a,b,c,d,e)
2086 #define IDirectPlay_SetPlayerName(p,a,b,c) (p)->lpVtbl->SetPlayerName(p,a,b,c)
2087
2088 #else /* C++ */
2089
2090 #define IDirectPlay_AddPlayerToGroup(p,a,b) (p)->AddPlayerToGroup(a,b)
2091 #define IDirectPlay_Close(p) (p)->Close()
2092 #define IDirectPlay_CreateGroup(p,a,b,c) (p)->CreateGroup(a,b,c)
2093 #define IDirectPlay_CreatePlayer(p,a,b,c,d) (p)->CreatePlayer(a,b,c,d)
2094 #define IDirectPlay_DeletePlayerFromGroup(p,a,b) (p)->DeletePlayerFromGroup(a,b)
2095 #define IDirectPlay_DestroyGroup(p,a) (p)->DestroyGroup(a)
2096 #define IDirectPlay_DestroyPlayer(p,a) (p)->DestroyPlayer(a)
2097 #define IDirectPlay_EnableNewPlayers(p,a) (p)->EnableNewPlayers(a)
2098 #define IDirectPlay_EnumGroupPlayers(p,a,b,c,d) (p)->EnumGroupPlayers(a,b,c,d)
2099 #define IDirectPlay_EnumGroups(p,a,b,c,d) (p)->EnumGroups(a,b,c,d)
2100 #define IDirectPlay_EnumPlayers(p,a,b,c,d) (p)->EnumPlayers(a,b,c,d)
2101 #define IDirectPlay_EnumSessions(p,a,b,c,d,e) (p)->EnumSessions(a,b,c,d,e)
2102 #define IDirectPlay_GetCaps(p,a) (p)->GetCaps(a)
2103 #define IDirectPlay_GetMessageCount(p,a,b) (p)->GetMessageCount(a,b)
2104 #define IDirectPlay_GetPlayerCaps(p,a,b) (p)->GetPlayerCaps(a,b)
2105 #define IDirectPlay_GetPlayerName(p,a,b,c,d,e) (p)->GetPlayerName(a,b,c,d,e)
2106 #define IDirectPlay_Initialize(p,a) (p)->Initialize(a)
2107 #define IDirectPlay_Open(p,a) (p)->Open(a)
2108 #define IDirectPlay_Receive(p,a,b,c,d,e) (p)->Receive(a,b,c,d,e)
2109 #define IDirectPlay_SaveSession(p,a) (p)->SaveSession(a)
2110 #define IDirectPlay_Send(p,a,b,c,d,e) (p)->Send(a,b,c,d,e)
2111 #define IDirectPlay_SetPlayerName(p,a,b,c) (p)->SetPlayerName(a,b,c)
2112
2113 #endif
2114
2115 DEFINE_GUID(IID_IDirectPlay, 0x5454e9a0, 0xdb65, 0x11ce, 0x92, 0x1c, 0x00, 0xaa, 0x00, 0x6c, 0x49, 0x72);
2116
2117 #endif // IDIRECTPLAY2_OR_GREATER
2118
2119 /****************************************************************************
2120 *
2121 * IDirectPlay macros (included regardless of IDIRECTPLAY2_OR_GREATER flag)
2122 *
2123 ****************************************************************************/
2124
2125 #if !defined(__cplusplus) || defined(CINTERFACE)
2126
2127 #define IDirectPlay_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
2128 #define IDirectPlay_AddRef(p) (p)->lpVtbl->AddRef(p)
2129 #define IDirectPlay_Release(p) (p)->lpVtbl->Release(p)
2130
2131 #else
2132
2133 #define IDirectPlay_QueryInterface(p,a,b) (p)->QueryInterface(a,b)
2134 #define IDirectPlay_AddRef(p) (p)->AddRef()
2135 #define IDirectPlay_Release(p) (p)->Release()
2136
2137 #endif // IDirectPlay interface macros
2138
2139 #ifdef __cplusplus
2140 };
2141 #endif
2142
2143 #pragma warning(default:4201)
2144
2145 #endif
2146
root@recompile.se
 ViewVC Help
Powered by ViewVC 1.1.26