2 * Copyright 2000 Peter Hunnisett
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 #ifndef __WINE_DIRECT_PLAY_SP_H
20 #define __WINE_DIRECT_PLAY_SP_H
25 /* GUID for IDirectPlaySP {0C9F6360-CC61-11cf-ACEC-00AA006886E3} */
26 DEFINE_GUID(IID_IDirectPlaySP
, 0xc9f6360, 0xcc61, 0x11cf, 0xac, 0xec, 0x0, 0xaa, 0x0, 0x68, 0x86, 0xe3);
27 typedef struct IDirectPlaySP IDirectPlaySP
, *LPDIRECTPLAYSP
;
30 typedef BOOL (CALLBACK
*LPENUMMRUCALLBACK
)( LPCVOID lpData
,
34 /* For SP. Top 16 bits is dplay, bottom 16 is SP */
35 #define DPSP_MAJORVERSION 0x00060000
36 #define DPSP_DX5VERSION 0x00050000
37 #define DPSP_DX3VERSION 0x00040000
39 #define DPSP_MAJORVERSIONMASK 0xFFFF0000
40 #define DPSP_MINORVERSIONMASK 0x0000FFFF
44 #define DPLAYI_PLAYER_SYSPLAYER 0x00000001
45 #define DPLAYI_PLAYER_NAMESRVR 0x00000002
46 #define DPLAYI_PLAYER_PLAYERINGROUP 0x00000004
47 #define DPLAYI_PLAYER_PLAYERLOCAL 0x00000008
48 #define DPLAYI_GROUP_SYSGROUP 0x00000020
49 #define DPLAYI_GROUP_DPLAYOWNS 0x00000040
50 #define DPLAYI_PLAYER_APPSERVER 0x00000080
51 #define DPLAYI_GROUP_HIDDEN 0x00000400
53 /* Define the COM interface */
54 #define INTERFACE IDirectPlaySP
55 #define IDirectPlaySP_METHODS \
57 STDMETHOD(AddMRUEntry)(THIS_ LPCWSTR lpSection, LPCWSTR lpKey, LPCVOID lpData, DWORD dwDataSize, DWORD dwMaxEntries ) PURE; \
58 STDMETHOD(CreateAddress)(THIS_ REFGUID guidSP, REFGUID guidDataType, LPCVOID lpData, DWORD dwDataSize, LPVOID lpAddress,LPDWORD lpdwAddressSize) PURE; \
59 STDMETHOD(EnumAddress)(THIS_ LPDPENUMADDRESSCALLBACK lpEnumAddressCallback, LPCVOID lpAddress, DWORD dwAddressSize, LPVOID lpContext ) PURE; \
60 STDMETHOD(EnumMRUEntries)(THIS_ LPCWSTR lpSection, LPCWSTR lpKey, LPENUMMRUCALLBACK lpEnumMRUCallback, LPVOID lpContext ) PURE; \
61 STDMETHOD(GetPlayerFlags)(THIS_ DPID idPlayer, LPDWORD lpdwPlayerFlags ) PURE; \
62 STDMETHOD(GetSPPlayerData)(THIS_ DPID idPlayer, LPVOID *lplpData, LPDWORD lpdwDataSize, DWORD dwFlags ) PURE; \
63 STDMETHOD(HandleMessage)(THIS_ LPVOID lpMessageBody, DWORD dwMessageBodySize, LPVOID lpMessageHeader ) PURE; \
64 STDMETHOD(SetSPPlayerData)(THIS_ DPID idPlayer, LPVOID lpData, DWORD dwDataSize, DWORD dwFlags ) PURE; \
65 STDMETHOD(CreateCompoundAddress)(THIS_ LPCDPCOMPOUNDADDRESSELEMENT lpElements, DWORD dwElementCount, LPVOID lpAddress, LPDWORD lpdwAddressSize ) PURE; \
66 STDMETHOD(GetSPData)(THIS_ LPVOID *lplpData, LPDWORD dwDataSize, DWORD dwFlags ) PURE; \
67 STDMETHOD(SetSPData)(THIS_ LPVOID lpData, DWORD dwDataSize, DWORD dwFlags ) PURE; \
68 STDMETHOD_(VOID,SendComplete)(THIS_ LPVOID , DWORD ) PURE;
69 ICOM_DEFINE(IDirectPlaySP
,IUnknown
)
73 /* NOTE: The microsoft provided header file doesn't have these access
77 /*** IUnknown methods ***/
78 #define IDirectPlaySP_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
79 #define IDirectPlaySP_AddRef(p) (p)->lpVtbl->AddRef(p)
80 #define IDirectPlaySP_Release(p) (p)->lpVtbl->Release(p)
81 /*** IDirectPlaySP methods ***/
82 #define IDirectPlaySP_AddMRUEntry(p,a,b,c,d,e) (p)->lpVtbl->AddMRUEntry(p,a,b,c,d,e)
83 #define IDirectPlaySP_CreateAddress(p,a,b,c,d,e,f) (p)->lpVtbl->CreateAddress(p,a,b,c,d,e,f)
84 #define IDirectPlaySP_EnumAddress(p,a,b,c,d) (p)->lpVtbl->EnumAddress(p,a,b,c,d)
85 #define IDirectPlaySP_EnumMRUEntries(p,a,b,c,d) (p)->lpVtbl->EnumMRUEntries(p,a,b,c,d)
86 #define IDirectPlaySP_GetPlayerFlags(p,a,b) (p)->lpVtbl->GetPlayerFlags(p,a,b)
87 #define IDirectPlaySP_GetSPPlayerData(p,a,b,c,d) (p)->lpVtbl->GetSPPlayerData(p,a,b,c,d)
88 #define IDirectPlaySP_HandleMessage(p,a,b,c) (p)->lpVtbl->HandleMessage(p,a,b,c)
89 #define IDirectPlaySP_SetSPPlayerData(p,a,b,c,d) (p)->lpVtbl->SetSPPlayerData(p,a,b,c,d)
90 #define IDirectPlaySP_CreateCompoundAddress(p,a,b,c,d) (p)->lpVtbl->CreateCompoundAddress(p,a,b,c,d)
91 #define IDirectPlaySP_GetSPData(p,a,b,c) (p)->lpVtbl->GetSPData(p,a,b,c)
92 #define IDirectPlaySP_SetSPData(p,a,b,c) (p)->lpVtbl->SetSPData(p,a,b,c)
93 #define IDirectPlaySP_SendComplete(p,a,b) (p)->lpVtbl->SendComplete(p,a,b)
96 /* SP Callback stuff */
98 typedef struct tagDPSP_ADDPLAYERTOGROUPDATA
102 IDirectPlaySP
* lpISP
;
103 } DPSP_ADDPLAYERTOGROUPDATA
, *LPDPSP_ADDPLAYERTOGROUPDATA
;
105 typedef struct tagDPSP_CLOSEDATA
107 IDirectPlaySP
* lpISP
;
108 } DPSP_CLOSEDATA
, *LPDPSP_CLOSEDATA
;
110 typedef struct tagDPSP_CREATEGROUPDATA
114 LPVOID lpSPMessageHeader
;
115 IDirectPlaySP
* lpISP
;
116 } DPSP_CREATEGROUPDATA
, *LPDPSP_CREATEGROUPDATA
;
118 typedef struct tagDPSP_CREATEPLAYERDATA
122 LPVOID lpSPMessageHeader
;
123 IDirectPlaySP
* lpISP
;
124 } DPSP_CREATEPLAYERDATA
, *LPDPSP_CREATEPLAYERDATA
;
126 typedef struct tagDPSP_DELETEGROUPDATA
130 IDirectPlaySP
* lpISP
;
131 } DPSP_DELETEGROUPDATA
, *LPDPSP_DELETEGROUPDATA
;
133 typedef struct tagDPSP_DELETEPLAYERDATA
137 IDirectPlaySP
* lpISP
;
138 } DPSP_DELETEPLAYERDATA
, *LPDPSP_DELETEPLAYERDATA
;
140 typedef struct tagDPSP_ENUMSESSIONSDATA
144 IDirectPlaySP
* lpISP
;
146 } DPSP_ENUMSESSIONSDATA
, *LPDPSP_ENUMSESSIONSDATA
;
148 typedef struct _DPSP_GETADDRESSDATA
152 LPDPADDRESS lpAddress
;
153 LPDWORD lpdwAddressSize
;
154 IDirectPlaySP
* lpISP
;
155 } DPSP_GETADDRESSDATA
, *LPDPSP_GETADDRESSDATA
;
157 typedef struct tagDPSP_GETADDRESSCHOICESDATA
159 LPDPADDRESS lpAddress
;
160 LPDWORD lpdwAddressSize
;
161 IDirectPlaySP
* lpISP
;
162 } DPSP_GETADDRESSCHOICESDATA
, *LPDPSP_GETADDRESSCHOICESDATA
;
164 typedef struct tagDPSP_GETCAPSDATA
169 IDirectPlaySP
* lpISP
;
170 } DPSP_GETCAPSDATA
, *LPDPSP_GETCAPSDATA
;
172 typedef struct tagDPSP_OPENDATA
175 LPVOID lpSPMessageHeader
;
176 IDirectPlaySP
* lpISP
;
179 DWORD dwSessionFlags
;
180 } DPSP_OPENDATA
, *LPDPSP_OPENDATA
;
182 typedef struct tagDPSP_REMOVEPLAYERFROMGROUPDATA
186 IDirectPlaySP
* lpISP
;
187 } DPSP_REMOVEPLAYERFROMGROUPDATA
, *LPDPSP_REMOVEPLAYERFROMGROUPDATA
;
189 typedef struct tagDPSP_REPLYDATA
191 LPVOID lpSPMessageHeader
;
195 IDirectPlaySP
* lpISP
;
196 } DPSP_REPLYDATA
, *LPDPSP_REPLYDATA
;
198 typedef struct tagDPSP_SENDDATA
206 IDirectPlaySP
* lpISP
;
207 } DPSP_SENDDATA
, *LPDPSP_SENDDATA
;
209 typedef struct tagDPSP_SENDTOGROUPDATA
216 IDirectPlaySP
* lpISP
;
217 } DPSP_SENDTOGROUPDATA
, *LPDPSP_SENDTOGROUPDATA
;
219 typedef struct tagDPSP_SENDEXDATA
221 IDirectPlaySP
* lpISP
;
225 LPSGBUFFER lpSendBuffers
;
233 } DPSP_SENDEXDATA
, *LPDPSP_SENDEXDATA
;
235 typedef struct tagDPSP_SENDTOGROUPEXDATA
237 IDirectPlaySP
* lpISP
;
241 LPSGBUFFER lpSendBuffers
;
248 } DPSP_SENDTOGROUPEXDATA
, *LPDPSP_SENDTOGROUPEXDATA
;
250 typedef struct tagDPSP_GETMESSAGEQUEUEDATA
252 IDirectPlaySP
* lpISP
;
257 LPDWORD lpdwNumBytes
;
258 } DPSP_GETMESSAGEQUEUEDATA
, *LPDPSP_GETMESSAGEQUEUEDATA
;
260 #define DPCANCELSEND_PRIORITY 0x00000001
261 #define DPCANCELSEND_ALL 0x00000002
263 typedef struct tagDPSP_CANCELDATA
265 IDirectPlaySP
* lpISP
;
267 LPRGLPVOID lprglpvSPMsgID
;
271 } DPSP_CANCELDATA
, *LPDPSP_CANCELDATA
;
273 typedef struct tagDPSP_SHUTDOWNDATA
275 IDirectPlaySP
* lpISP
;
276 } DPSP_SHUTDOWNDATA
, *LPDPSP_SHUTDOWNDATA
;
279 /* Prototypes returned by SPInit */
280 typedef HRESULT (WINAPI
*LPDPSP_CREATEPLAYER
)(LPDPSP_CREATEPLAYERDATA
);
281 typedef HRESULT (WINAPI
*LPDPSP_DELETEPLAYER
)(LPDPSP_DELETEPLAYERDATA
);
282 typedef HRESULT (WINAPI
*LPDPSP_SEND
)(LPDPSP_SENDDATA
);
283 typedef HRESULT (WINAPI
*LPDPSP_ENUMSESSIONS
)(LPDPSP_ENUMSESSIONSDATA
);
284 typedef HRESULT (WINAPI
*LPDPSP_REPLY
)(LPDPSP_REPLYDATA
);
285 typedef HRESULT (WINAPI
*LPDPSP_SHUTDOWN
)(void);
286 typedef HRESULT (WINAPI
*LPDPSP_CREATEGROUP
)(LPDPSP_CREATEGROUPDATA
);
287 typedef HRESULT (WINAPI
*LPDPSP_DELETEGROUP
)(LPDPSP_DELETEGROUPDATA
);
288 typedef HRESULT (WINAPI
*LPDPSP_ADDPLAYERTOGROUP
)(LPDPSP_ADDPLAYERTOGROUPDATA
);
289 typedef HRESULT (WINAPI
*LPDPSP_REMOVEPLAYERFROMGROUP
)(LPDPSP_REMOVEPLAYERFROMGROUPDATA
);
290 typedef HRESULT (WINAPI
*LPDPSP_GETCAPS
)(LPDPSP_GETCAPSDATA
);
291 typedef HRESULT (WINAPI
*LPDPSP_GETADDRESS
)(LPDPSP_GETADDRESSDATA
);
292 typedef HRESULT (WINAPI
*LPDPSP_GETADDRESSCHOICES
)(LPDPSP_GETADDRESSCHOICESDATA
);
293 typedef HRESULT (WINAPI
*LPDPSP_OPEN
)(LPDPSP_OPENDATA
);
294 typedef HRESULT (WINAPI
*LPDPSP_CLOSE
)(void);
295 typedef HRESULT (WINAPI
*LPDPSP_SENDTOGROUP
)(LPDPSP_SENDTOGROUPDATA
);
296 typedef HRESULT (WINAPI
*LPDPSP_SHUTDOWNEX
)(LPDPSP_SHUTDOWNDATA
);
297 typedef HRESULT (WINAPI
*LPDPSP_CLOSEEX
)(LPDPSP_CLOSEDATA
);
298 typedef HRESULT (WINAPI
*LPDPSP_SENDEX
)(LPDPSP_SENDEXDATA
);
299 typedef HRESULT (WINAPI
*LPDPSP_SENDTOGROUPEX
)(LPDPSP_SENDTOGROUPEXDATA
);
300 typedef HRESULT (WINAPI
*LPDPSP_CANCEL
)(LPDPSP_CANCELDATA
);
301 typedef HRESULT (WINAPI
*LPDPSP_GETMESSAGEQUEUE
)(LPDPSP_GETMESSAGEQUEUEDATA
);
304 typedef struct tagDPSP_SPCALLBACKS
309 LPDPSP_ENUMSESSIONS EnumSessions
; /* Must be provided */
310 LPDPSP_REPLY Reply
; /* Must be provided */
311 LPDPSP_SEND Send
; /* Must be provided */
312 LPDPSP_ADDPLAYERTOGROUP AddPlayerToGroup
; /* Optional */
313 LPDPSP_CLOSE Close
; /* Optional */
314 LPDPSP_CREATEGROUP CreateGroup
; /* Optional */
315 LPDPSP_CREATEPLAYER CreatePlayer
; /* Optional */
316 LPDPSP_DELETEGROUP DeleteGroup
; /* Optional */
317 LPDPSP_DELETEPLAYER DeletePlayer
; /* Optional */
318 LPDPSP_GETADDRESS GetAddress
; /* Optional */
319 LPDPSP_GETCAPS GetCaps
; /* Optional */
320 LPDPSP_OPEN Open
; /* Optional */
321 LPDPSP_REMOVEPLAYERFROMGROUP RemovePlayerFromGroup
; /* Optional */
322 LPDPSP_SENDTOGROUP SendToGroup
; /* Optional */
323 LPDPSP_SHUTDOWN Shutdown
; /* Optional */
325 LPDPSP_CLOSEEX CloseEx
; /* Optional */
326 LPDPSP_SHUTDOWNEX ShutdownEx
; /* Optional */
327 LPDPSP_GETADDRESSCHOICES GetAddressChoices
; /* Optional */
329 LPDPSP_SENDEX SendEx
; /* Optional */
330 LPDPSP_SENDTOGROUPEX SendToGroupEx
; /* Optional */
331 LPDPSP_CANCEL Cancel
; /* Optional */
332 LPDPSP_GETMESSAGEQUEUE GetMessageQueue
; /* Optional */
333 } DPSP_SPCALLBACKS
, *LPDPSP_SPCALLBACKS
;
335 typedef struct tagSPINITDATA
337 LPDPSP_SPCALLBACKS lpCB
;
338 IDirectPlaySP
* lpISP
;
343 DWORD dwSPHeaderSize
;
344 LPDPADDRESS lpAddress
;
347 } SPINITDATA
, *LPSPINITDATA
;
349 typedef HRESULT (WINAPI
*LPDPSP_SPINIT
)(LPSPINITDATA
);
351 /* This variable is exported from the DLL at ordinal 6 to be accessed by the
354 extern DWORD gdwDPlaySPRefCount
;