1 #ifndef __WINE_DPLOBBY_H
2 #define __WINE_DPLOBBY_H
4 /* FIXME: GCC doesn't yet support annon structures so some of the structures defined here don't match the sdk exactly.
5 * I've tried to come up with suitably terse names, but this file won't cut it for inclusion into a WineLib app.
12 #endif /* defined(__cplusplus) */
16 /*****************************************************************************
17 * Predeclare the interfaces
19 DEFINE_GUID(CLSID_DirectPlayLobby, 0x2fe8f810, 0xb2a5, 0x11d0, 0xa7, 0x87, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
21 DEFINE_GUID(IID_IDirectPlayLobby, 0xaf465c71, 0x9588, 0x11cf, 0xa0, 0x20, 0x0, 0xaa, 0x0, 0x61, 0x57, 0xac);
22 typedef struct IDirectPlayLobby IDirectPlayLobby,*LPDIRECTPLAYLOBBY;
24 DEFINE_GUID(IID_IDirectPlayLobbyA, 0x26c66a70, 0xb367, 0x11cf, 0xa0, 0x24, 0x0, 0xaa, 0x0, 0x61, 0x57, 0xac);
25 typedef struct IDirectPlayLobby IDirectPlayLobbyA,*LPDIRECTPLAYLOBBYA;
27 DEFINE_GUID(IID_IDirectPlayLobby2, 0x194c220, 0xa303, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
28 typedef struct IDirectPlayLobby2 IDirectPlayLobby2, *LPDIRECTPLAYLOBBY2;
30 DEFINE_GUID(IID_IDirectPlayLobby2A, 0x1bb4af80, 0xa303, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
31 typedef struct IDirectPlayLobby2 IDirectPlayLobby2A, *LPDIRECTPLAYLOBBY2A;
33 DEFINE_GUID(IID_IDirectPlayLobby3, 0x2db72490, 0x652c, 0x11d1, 0xa7, 0xa8, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
34 typedef struct IDirectPlayLobby3 IDirectPlayLobby3, *LPDIRECTPLAYLOBBY3;
36 DEFINE_GUID(IID_IDirectPlayLobby3A, 0x2db72491, 0x652c, 0x11d1, 0xa7, 0xa8, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
37 typedef struct IDirectPlayLobby3 IDirectPlayLobby3A, *LPDIRECTPLAYLOBBY3A;
40 /*****************************************************************************
41 * DirectPlayLobby Property GUIDs used in lobby messages
44 /* DPLPROPERTY_MessagesSupported {762CCDA1-D916-11d0-BA39-00C04FD7ED67}.
45 * Purpose: Request if the lobby supports standard (?).
46 * Response: Answer is a BOOL. TRUE if supports the standard (?) and FALSE otherwise. Of course, it might not respond at all.
48 DEFINE_GUID(DPLPROPERTY_MessagesSupported, 0x762ccda1, 0xd916, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
50 /* DPLPROPERTY_LobbyGuid {F56920A0-D218-11d0-BA39-00C04FD7ED67}.
51 * Purpose: Request the GUID that identifies the lobby version that the application is communicating with.
52 * Response: The GUID which identifies the lobby version
54 DEFINE_GUID(DPLPROPERTY_LobbyGuid, 0xf56920a0, 0xd218, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
56 /* DPLPROPERTY_PlayerGuid {B4319322-D20D-11d0-BA39-00C04FD7ED67}
57 * Purpose: Request the GUID that identifies the player for this particular machine.
58 * Response: DPLDATA_PLAYERDATA structure.
60 DEFINE_GUID(DPLPROPERTY_PlayerGuid, 0xb4319322, 0xd20d, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
62 /* DPLPROPERTY_PlayerScore {48784000-D219-11d0-BA39-00C04FD7ED67}
63 * Purpose: Used to send a score of a player to the lobby. The format is an array of long integers.
64 * Response: I don't think there is one.
66 DEFINE_GUID(DPLPROPERTY_PlayerScore, 0x48784000, 0xd219, 0x11d0, 0xba, 0x39, 0x0, 0xc0, 0x4f, 0xd7, 0xed, 0x67);
70 /*****************************************************************************
71 * LOBBY structures associated with GUID messages
74 typedef struct tagDPLDATA_PLAYERGUID
78 } DPLDATA_PLAYERGUID, *LPDPLDATA_PLAYERGUID;
80 typedef struct tagDPLDATA_PLAYERSCORE
84 } DPLDATA_PLAYERSCORE, *LPDPLDATA_PLAYERSCORE;
87 /*****************************************************************************
88 * LOBBY messages and message data structures.
90 * System messages can be identified by dwMessageFlags having a value of DPLMSG_SYSTEM
91 * after a call to ReceiveLobbyMessage.
93 * Standard messages can be indentified by dwMessageFlags having a value of DPLMSG_STANDARD
94 * after a call to ReceiveLobbyMessage.
97 /* DPLobby1 definition required for backwards compatibility */
98 #define DPLMSG_SYSTEM 0x00000001
99 #define DPLMSG_STANDARD 0x00000002
100 #define DPLAD_SYSTEM DPLMSG_SYSTEM
103 /* System messages - dwType field for messages */
104 #define DPLSYS_CONNECTIONSETTINGSREAD 0x00000001
105 #define DPLSYS_DPLAYCONNECTFAILED 0x00000002
106 #define DPLSYS_DPLAYCONNECTSUCCEEDED 0x00000003
107 #define DPLSYS_APPTERMINATED 0x00000004
108 #define DPLSYS_SETPROPERTY 0x00000005
109 #define DPLSYS_SETPROPERTYRESPONSE 0x00000006
110 #define DPLSYS_GETPROPERTY 0x00000007
111 #define DPLSYS_GETPROPERTYRESPONSE 0x00000008
112 #define DPLSYS_NEWSESSIONHOST 0x00000009
113 #define DPLSYS_NEWCONNECTIONSETTINGS 0x0000000A
117 /* Used to indentify the message type */
118 typedef struct tagDPLMSG_GENERIC
120 DWORD dwType; /* Message type */
121 } DPLMSG_GENERIC, *LPDPLMSG_GENERIC;
123 /* Generic format for system messages - see above */
124 typedef struct tagDPLMSG_SYSTEMMESSAGE
126 DWORD dwType; /* Message type */
127 GUID guidInstance; /* Instance GUID of the dplay session the message corresponds to */
128 } DPLMSG_SYSTEMMESSAGE, *LPDPLMSG_SYSTEMMESSAGE;
130 /* Generic message to set a property - see property GUIDs above */
131 typedef struct tagDPLMSG_SETPROPERTY
133 DWORD dwType; /* Message type */
134 DWORD dwRequestID; /* Request ID (DPL_NOCONFIRMATION if no confirmation desired) */
135 GUID guidPlayer; /* Player GUID */
136 GUID guidPropertyTag; /* Property GUID */
137 DWORD dwDataSize; /* Size of data */
138 DWORD dwPropertyData[1]; /* Buffer containing data */
139 } DPLMSG_SETPROPERTY, *LPDPLMSG_SETPROPERTY;
141 #define DPL_NOCONFIRMATION 0L
143 /* Reply to DPLMSG_SETPROPERTY */
144 typedef struct tagDPLMSG_SETPROPERTYRESPONSE
146 DWORD dwType; /* Message type */
147 DWORD dwRequestID; /* Request ID */
148 GUID guidPlayer; /* Player GUID */
149 GUID guidPropertyTag; /* Property GUID */
150 HRESULT hr; /* Return Code */
151 } DPLMSG_SETPROPERTYRESPONSE, *LPDPLMSG_SETPROPERTYRESPONSE;
153 /* Request to get the present value of a property */
154 typedef struct tagDPLMSG_GETPROPERTY
156 DWORD dwType; /* Message type */
157 DWORD dwRequestID; /* Request ID */
158 GUID guidPlayer; /* Player GUID */
159 GUID guidPropertyTag; /* Property GUID */
160 } DPLMSG_GETPROPERTY, *LPDPLMSG_GETPROPERTY;
162 /* Response to a request to get the present value of a property */
163 typedef struct tagDPLMSG_GETPROPERTYRESPONSE
165 DWORD dwType; /* Message type */
166 DWORD dwRequestID; /* Request ID */
167 GUID guidPlayer; /* Player GUID */
168 GUID guidPropertyTag; /* Property GUID */
169 HRESULT hr; /* Return Code */
170 DWORD dwDataSize; /* Size of data */
171 DWORD dwPropertyData[1]; /* Buffer containing data */
172 } DPLMSG_GETPROPERTYRESPONSE, *LPDPLMSG_GETPROPERTYRESPONSE;
174 /* Standard message in response to a session host migration to a new client */
175 typedef struct tagDPLMSG_NEWSESSIONHOST
177 DWORD dwType; /* Message type */
178 GUID guidInstance; /* GUID Instance of the session */
179 } DPLMSG_NEWSESSIONHOST, *LPDPLMSG_NEWSESSIONHOST;
181 /*****************************************************************************
182 * DirectPlay Address ID's
183 * A DirectPlay address is composed of multiple data chunks, each assocated with
184 * a GUID to give significance to the type of data. All chunks have an associated
185 * size so that unknown chunks can be ignored for backwards compatibility!
186 * EnumAddresses function is used to parse the address data chunks.
189 /* DPAID_TotalSize {1318F560-912C-11d0-9DAA-00A0C90A43CB}
190 * Chunk purpose: Chunk is a DWORD containing the size of the entire DPADDRESS struct
192 DEFINE_GUID(DPAID_TotalSize, 0x1318f560, 0x912c, 0x11d0, 0x9d, 0xaa, 0x0, 0xa0, 0xc9, 0xa, 0x43, 0xcb);
194 /* DPAID_ServiceProvider {07D916C0-E0AF-11cf-9C4E-00A0C905425E}
195 * Chunk purpose: Chunk is a GUID indicated what service provider created the chunk.
197 DEFINE_GUID(DPAID_ServiceProvider, 0x7d916c0, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
199 /* DPAID_LobbyProvider {59B95640-9667-11d0-A77D-0000F803ABFC}
200 * Chunk purpose: Chunk is a GUID indicating what lobby provider created the chunk.
202 DEFINE_GUID(DPAID_LobbyProvider, 0x59b95640, 0x9667, 0x11d0, 0xa7, 0x7d, 0x0, 0x0, 0xf8, 0x3, 0xab, 0xfc);
204 /* DPAID_Phone {78EC89A0-E0AF-11cf-9C4E-00A0C905425E} -- ANSI
205 * DPAID_PhoneW {BA5A7A70-9DBF-11d0-9CC1-00A0C905425E} -- UNICODE
206 * Chunk purpose: Chunk is a phone number in ANSI or UNICODE format
208 DEFINE_GUID(DPAID_Phone, 0x78ec89a0, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
209 DEFINE_GUID(DPAID_PhoneW, 0xba5a7a70, 0x9dbf, 0x11d0, 0x9c, 0xc1, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
211 /* DPAID_Modem {F6DCC200-A2FE-11d0-9C4F-00A0C905425E} -- ANSI
212 * DPAID_ModemW {01FD92E0-A2FF-11d0-9C4F-00A0C905425E} -- UNICODE
213 * Chunk purpose: Chunk is a modem name registered with TAPI
215 DEFINE_GUID(DPAID_Modem, 0xf6dcc200, 0xa2fe, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
216 DEFINE_GUID(DPAID_ModemW, 0x1fd92e0, 0xa2ff, 0x11d0, 0x9c, 0x4f, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
218 /* DPAID_INet {C4A54DA0-E0AF-11cf-9C4E-00A0C905425E} -- ANSI
219 * DPAID_INetW {E63232A0-9DBF-11d0-9CC1-00A0C905425E} -- UNICODE
220 * Chunk purpose: Chunk is a string containing a TCP/IP host name or IP address
222 DEFINE_GUID(DPAID_INet, 0xc4a54da0, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
223 DEFINE_GUID(DPAID_INetW, 0xe63232a0, 0x9dbf, 0x11d0, 0x9c, 0xc1, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
225 /* DPAID_INetPort {E4524541-8EA5-11d1-8A96-006097B01411}
226 * Chunk purpose: Chunk is a port number used for creating TCP and UDP sockets. (WORD)
228 DEFINE_GUID(DPAID_INetPort, 0xe4524541, 0x8ea5, 0x11d1, 0x8a, 0x96, 0x0, 0x60, 0x97, 0xb0, 0x14, 0x11);
230 /* DPAID_ComPort {F2F0CE00-E0AF-11cf-9C4E-00A0C905425E}
231 * Chunk purpose: Chunk contains the description of a serial port.
233 DEFINE_GUID(DPAID_ComPort, 0xf2f0ce00, 0xe0af, 0x11cf, 0x9c, 0x4e, 0x0, 0xa0, 0xc9, 0x5, 0x42, 0x5e);
236 /* Header block for address data elements */
237 typedef struct tagDPADDRESS
241 } DPADDRESS, *LPDPADDRESS;
244 /* Used for specification of a communication port. Baud rate, stop bits and
245 * parity bits can be found in winbase.h. These are flow control constants only.
247 #define DPCPA_NOFLOW 0 /* no flow control */
248 #define DPCPA_XONXOFFFLOW 1 /* software flow control */
249 #define DPCPA_RTSFLOW 2 /* hardware flow control with RTS */
250 #define DPCPA_DTRFLOW 3 /* hardware flow control with DTR */
251 #define DPCPA_RTSDTRFLOW 4 /* hardware flow control with RTS and DTR */
253 typedef struct tagDPCOMPORTADDRESS
255 DWORD dwComPort; /* COM port to use (1-4) */
256 DWORD dwBaudRate; /* baud rate (100-256k) */
257 DWORD dwStopBits; /* no. stop bits (1-2) */
258 DWORD dwParity; /* parity (none, odd, even, mark) */
259 DWORD dwFlowControl; /* flow control (none, xon/xoff, rts, dtr) */
260 } DPCOMPORTADDRESS, *LPDPCOMPORTADDRESS;
264 /****************************************************************************
268 typedef struct tagDPLAPPINFO
271 GUID guidApplication;
279 } DPLAPPINFO, *LPDPLAPPINFO;
280 typedef const DPLAPPINFO *LPCDPLAPPINFO;
282 typedef struct DPCOMPOUNDADDRESSELEMENT
287 } DPCOMPOUNDADDRESSELEMENT, *LPDPCOMPOUNDADDRESSELEMENT;
288 typedef const DPCOMPOUNDADDRESSELEMENT *LPCDPCOMPOUNDADDRESSELEMENT;
290 typedef struct tagDPAPPLICATIONDESC
297 LPSTR lpszApplicationNameA;
298 LPWSTR lpszApplicationName;
301 GUID guidApplication;
311 LPSTR lpszCommandLineA;
312 LPWSTR lpszCommandLine;
323 LPSTR lpszCurrentDirectoryA;
324 LPWSTR lpszCurrentDirectory;
327 LPSTR lpszDescriptionA;
328 LPWSTR lpszDescriptionW;
330 } DPAPPLICATIONDESC, *LPDPAPPLICATIONDESC;
334 extern HRESULT WINAPI DirectPlayLobbyCreateW(LPGUID, LPDIRECTPLAYLOBBY*, IUnknown*, LPVOID, DWORD );
335 extern HRESULT WINAPI DirectPlayLobbyCreateA(LPGUID, LPDIRECTPLAYLOBBYA*, IUnknown*, LPVOID, DWORD );
339 typedef BOOL CALLBACK (*LPDPENUMADDRESSCALLBACK)(
340 REFGUID guidDataType,
345 typedef BOOL CALLBACK (*LPDPLENUMADDRESSTYPESCALLBACK)(
346 REFGUID guidDataType,
350 typedef BOOL CALLBACK (*LPDPLENUMLOCALAPPLICATIONSCALLBACK)(
351 LPCDPLAPPINFO lpAppInfo,
357 /*****************************************************************************
358 * IDirectPlayLobby and IDirectPlayLobbyA interface
360 #define ICOM_INTERFACE IDirectPlayLobby
361 #define IDirectPlayLobby_METHODS \
362 ICOM_METHOD3(HRESULT,Connect, DWORD,, LPDIRECTPLAY2*,, IUnknown*,) \
363 ICOM_METHOD6(HRESULT,CreateAddress, REFGUID,, REFGUID,, LPCVOID,, DWORD,, LPVOID,, LPDWORD,) \
364 ICOM_METHOD4(HRESULT,EnumAddress, LPDPENUMADDRESSCALLBACK,, LPCVOID,, DWORD,, LPVOID,) \
365 ICOM_METHOD4(HRESULT,EnumAddressTypes, LPDPLENUMADDRESSTYPESCALLBACK,, REFGUID,, LPVOID,, DWORD,) \
366 ICOM_METHOD3(HRESULT,EnumLocalApplications, LPDPLENUMLOCALAPPLICATIONSCALLBACK,, LPVOID,, DWORD,) \
367 ICOM_METHOD3(HRESULT,GetConnectionSettings, DWORD,, LPVOID,, LPDWORD,) \
368 ICOM_METHOD5(HRESULT,ReceiveLobbyMessage, DWORD,, DWORD,, LPDWORD,, LPVOID,, LPDWORD,) \
369 ICOM_METHOD4(HRESULT,RunApplication, DWORD,, LPDWORD,, LPDPLCONNECTION,, HANDLE,) \
370 ICOM_METHOD4(HRESULT,SendLobbyMessage, DWORD,, DWORD,, LPVOID,, DWORD,) \
371 ICOM_METHOD3(HRESULT,SetConnectionSettings, DWORD,, DWORD,, LPDPLCONNECTION,) \
372 ICOM_METHOD3(HRESULT,SetLobbyMessageEvent, DWORD,, DWORD,, HANDLE,)
373 #define IDirectPlayLobby_IMETHODS \
375 IDirectPlayLobby_METHODS
376 ICOM_DEFINE(IDirectPlayLobby,IUnknown)
377 #undef ICOM_INTERFACE
379 /*****************************************************************************
380 * IDirectPlayLobby2 and IDirectPlayLobby2A interface
382 #define ICOM_INTERFACE IDirectPlayLobby2
383 #define IDirectPlayLobby2_METHODS \
384 ICOM_METHOD4(HRESULT,CreateCompoundAddress, LPCDPCOMPOUNDADDRESSELEMENT,, DWORD,, LPVOID,, LPDWORD,)
385 #define IDirectPlayLobby2_IMETHODS \
386 IDirectPlayLobby_IMETHODS \
387 IDirectPlayLobby2_METHODS
388 ICOM_DEFINE(IDirectPlayLobby2,IDirectPlayLobby)
389 #undef ICOM_INTERFACE
391 /*****************************************************************************
392 * IDirectPlayLobby3 and IDirectPlayLobby3A interface
394 #define ICOM_INTERFACE IDirectPlayLobby3
395 #define IDirectPlayLobby3_METHODS \
396 ICOM_METHOD4( HRESULT, ConnectEx, DWORD,, REFIID,, LPVOID *,, IUnknown *,) \
397 ICOM_METHOD2( HRESULT, RegisterApplication, DWORD,, LPDPAPPLICATIONDESC, ) \
398 ICOM_METHOD2( HRESULT, UnregisterApplication, DWORD,, REFGUID, ) \
399 ICOM_METHOD1( HRESULT, WaitForConnectionSettings, DWORD, )
401 #define IDirectPlayLobby3_IMETHODS \
402 IDirectPlayLobby2_IMETHODS \
403 IDirectPlayLobby3_METHODS
404 ICOM_DEFINE(IDirectPlayLobby3,IDirectPlayLobby2)
405 #undef ICOM_INTERFACE
407 #define IDirectPlayLobby_QueryInterface(p,a,b) ICOM_CALL2(QueryInterface,p,a,b)
408 #define IDirectPlayLobby_AddRef(p) ICOM_CALL (AddRef,p)
409 #define IDirectPlayLobby_Release(p) ICOM_CALL (Release,p)
410 #define IDirectPlayLobby_Connect(p,a,b,c) ICOM_CALL3(Connect,p,a,b,c)
411 #define IDirectPlayLobby_ConnectEx(p,a,b,c,d) ICOM_CALL4(ConnectEx,p,a,b,c,d)
412 #define IDirectPlayLobby_CreateAddress(p,a,b,c,d,e,f) ICOM_CALL6(CreateAddress,p,a,b,c,d,e,f)
413 #define IDirectPlayLobby_CreateCompoundAddress(p,a,b,c,d) ICOM_CALL4(CreateCompoundAddress,p,a,b,c,d)
414 #define IDirectPlayLobby_EnumAddress(p,a,b,c,d) ICOM_CALL4(EnumAddress,p,a,b,c,d)
415 #define IDirectPlayLobby_EnumAddressTypes(p,a,b,c,d) ICOM_CALL4(EnumAddressTypes,p,a,b,c,d)
416 #define IDirectPlayLobby_EnumLocalApplications(p,a,b,c) ICOM_CALL3(EnumLocalApplications,p,a,b,c)
417 #define IDirectPlayLobby_GetConnectionSettings(p,a,b,c) ICOM_CALL3(GetConnectionSettings,p,a,b,c)
418 #define IDirectPlayLobby_ReceiveLobbyMessage(p,a,b,c,d,e) ICOM_CALL5(ReceiveLobbyMessage,p,a,b,c,d,e)
419 #define IDirectPlayLobby_RegisterApplication(p,a,b) ICOM_CALL2(RegisterApplication,p,a,b)
420 #define IDirectPlayLobby_RunApplication(p,a,b,c,d) ICOM_CALL4(RunApplication,p,a,b,c,d)
421 #define IDirectPlayLobby_SendLobbyMessage(p,a,b,c,d) ICOM_CALL4(SendLobbyMessage,p,a,b,c,d)
422 #define IDirectPlayLobby_SetConnectionSettings(p,a,b,c) ICOM_CALL3(SetConnectionSettings,p,a,b,c)
423 #define IDirectPlayLobby_SetLobbyMessageEvent(p,a,b,c) ICOM_CALL3(SetLobbyMessageEvent,p,a,b,c)
424 #define IDirectPlayLobby_UnregisterApplication(p,a,b) ICOM_CALL2(UnregisterApplication,p,a,b)
425 #define IDirectPlayLobby_WaitForConnectionSettings(p,a) ICOM_CALL1(WaitForConnectionSettings,p,a)
427 /* Used for WaitForConnectionSettings */
428 #define DPLWAIT_CANCEL 0x00000001
432 #endif /* defined(__cplusplus) */
434 #endif /* __WINE_DPLOBBY_H */