Extract file directly to their target location, bypassing the need to
[wine/multimedia.git] / include / dsdriver.h
blob31f591af04466f959ab2a4b720bcd5bd6d8a670c
1 /*
2 * DirectSound driver
3 * (DirectX 5 version)
5 * Copyright (C) 2000 Ove Kaaven
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 #ifndef __WINE_DSDRIVER_H
23 #define __WINE_DSDRIVER_H
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
29 /*****************************************************************************
30 * Predeclare the interfaces
32 DEFINE_GUID(IID_IDsDriver, 0x8C4233C0l, 0xB4CC, 0x11CE, 0x92, 0x94, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00);
33 typedef struct IDsDriver *PIDSDRIVER;
35 DEFINE_GUID(IID_IDsDriverBuffer, 0x8C4233C1l, 0xB4CC, 0x11CE, 0x92, 0x94, 0x44, 0x45, 0x53, 0x54, 0x00, 0x00);
36 typedef struct IDsDriverBuffer *PIDSDRIVERBUFFER;
38 DEFINE_GUID(IID_IDsDriverPropertySet, 0x0F6F2E8E0, 0xD842, 0x11D0, 0x8F, 0x75, 0x00, 0xC0, 0x4F, 0xC2, 0x8A, 0xCA);
39 typedef struct IDsDriverPropertySet *PIDSDRIVERPROPERTYSET;
41 DEFINE_GUID(IID_IDsDriverNotify, 0x00363EF44, 0x3B57, 0x11D3, 0xAC, 0x79, 0x00, 0x10, 0x5A, 0x01, 0x7f, 0xe1);
42 typedef struct IDsDriverNotify *PIDSDRIVERNOTIFY;
44 DEFINE_GUID(IID_IDsCaptureDriver, 0x03DD10C47, 0x74FB, 0x11D3, 0x90, 0x49, 0xCB, 0xB4, 0xB3, 0x2E, 0xAA, 0x08);
45 typedef struct IDsCaptureDriver *PIDSCDRIVER;
47 DEFINE_GUID(IID_IDsCaptureDriverBuffer, 0x03DD10C48, 0x74FB, 0x11D3, 0x90, 0x49, 0xCB, 0xB4, 0xB3, 0x2E, 0xAA, 0x08);
48 typedef struct IDsCaptureDriverBuffer *PIDSCDRIVERBUFFER;
50 #define DSDDESC_DOMMSYSTEMOPEN 0x00000001
51 #define DSDDESC_DOMMSYSTEMSETFORMAT 0x00000002
52 #define DSDDESC_USESYSTEMMEMORY 0x00000004
53 #define DSDDESC_DONTNEEDPRIMARYLOCK 0x00000008
54 #define DSDDESC_DONTNEEDSECONDARYLOCK 0x00000010
56 #define DSDHEAP_NOHEAP 0
57 #define DSDHEAP_CREATEHEAP 1
58 #define DSDHEAP_USEDIRECTDRAWHEAP 2
59 #define DSDHEAP_PRIVATEHEAP 3
61 typedef struct _DSDRIVERDESC
63 DWORD dwFlags;
64 CHAR szDesc[256];
65 CHAR szDrvname[256];
66 DWORD dnDevNode;
67 WORD wVxdId;
68 WORD wReserved;
69 ULONG ulDeviceNum;
70 DWORD dwHeapType;
71 LPVOID pvDirectDrawHeap;
72 DWORD dwMemStartAddress;
73 DWORD dwMemEndAddress;
74 DWORD dwMemAllocExtra;
75 LPVOID pvReserved1;
76 LPVOID pvReserved2;
77 } DSDRIVERDESC,*PDSDRIVERDESC;
79 typedef struct _DSDRIVERCAPS
81 DWORD dwFlags;
82 DWORD dwMinSecondarySampleRate;
83 DWORD dwMaxSecondarySampleRate;
84 DWORD dwPrimaryBuffers;
85 DWORD dwMaxHwMixingAllBuffers;
86 DWORD dwMaxHwMixingStaticBuffers;
87 DWORD dwMaxHwMixingStreamingBuffers;
88 DWORD dwFreeHwMixingAllBuffers;
89 DWORD dwFreeHwMixingStaticBuffers;
90 DWORD dwFreeHwMixingStreamingBuffers;
91 DWORD dwMaxHw3DAllBuffers;
92 DWORD dwMaxHw3DStaticBuffers;
93 DWORD dwMaxHw3DStreamingBuffers;
94 DWORD dwFreeHw3DAllBuffers;
95 DWORD dwFreeHw3DStaticBuffers;
96 DWORD dwFreeHw3DStreamingBuffers;
97 DWORD dwTotalHwMemBytes;
98 DWORD dwFreeHwMemBytes;
99 DWORD dwMaxContigFreeHwMemBytes;
100 } DSDRIVERCAPS,*PDSDRIVERCAPS;
102 typedef struct _DSVOLUMEPAN
104 DWORD dwTotalLeftAmpFactor;
105 DWORD dwTotalRightAmpFactor;
106 LONG lVolume;
107 DWORD dwVolAmpFactor;
108 LONG lPan;
109 DWORD dwPanLeftAmpFactor;
110 DWORD dwPanRightAmpFactor;
111 } DSVOLUMEPAN,*PDSVOLUMEPAN;
113 typedef union _DSPROPERTY
115 struct {
116 GUID Set;
117 ULONG Id;
118 ULONG Flags;
119 ULONG InstanceId;
120 } DUMMYSTRUCTNAME;
121 ULONGLONG Alignment;
122 } DSPROPERTY,*PDSPROPERTY;
124 typedef struct _DSCDRIVERCAPS
126 DWORD dwSize;
127 DWORD dwFlags;
128 DWORD dwFormats;
129 DWORD dwChannels;
130 } DSCDRIVERCAPS,*PDSCDRIVERCAPS;
132 /*****************************************************************************
133 * IDsDriver interface
135 #define INTERFACE IDsDriver
136 DECLARE_INTERFACE_(IDsDriver,IUnknown)
138 /*** IUnknown methods ***/
139 STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
140 STDMETHOD_(ULONG,AddRef)(THIS) PURE;
141 STDMETHOD_(ULONG,Release)(THIS) PURE;
142 /*** IDsDriver methods ***/
143 STDMETHOD(GetDriverDesc)(THIS_ PDSDRIVERDESC pDsDriverDesc) PURE;
144 STDMETHOD(Open)(THIS) PURE;
145 STDMETHOD(Close)(THIS) PURE;
146 STDMETHOD(GetCaps)(THIS_ PDSDRIVERCAPS pDsDrvCaps) PURE;
147 STDMETHOD(CreateSoundBuffer)(THIS_ LPWAVEFORMATEX pwfx,DWORD dwFlags,DWORD dwCardAddress,LPDWORD pdwcbBufferSize,LPBYTE *ppbBuffer,LPVOID *ppvObj) PURE;
148 STDMETHOD(DuplicateSoundBuffer)(THIS_ PIDSDRIVERBUFFER pIDsDriverBuffer,LPVOID *ppvObj) PURE;
150 #undef INTERFACE
152 #if !defined (__cplusplus) || defined(CINTERFACE)
153 /*** IUnknown methods ***/
154 #define IDsDriver_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
155 #define IDsDriver_AddRef(p) (p)->lpVtbl->AddRef(p)
156 #define IDsDriver_Release(p) (p)->lpVtbl->Release(p)
157 /*** IDsDriver methods ***/
158 #define IDsDriver_GetDriverDesc(p,a) (p)->lpVtbl->GetDriverDesc(p,a)
159 #define IDsDriver_Open(p) (p)->lpVtbl->Open(p)
160 #define IDsDriver_Close(p) (p)->lpVtbl->Close(p)
161 #define IDsDriver_GetCaps(p,a) (p)->lpVtbl->GetCaps(p,a)
162 #define IDsDriver_CreateSoundBuffer(p,a,b,c,d,e,f) (p)->lpVtbl->CreateSoundBuffer(p,a,b,c,d,e,f)
163 #define IDsDriver_DuplicateSoundBuffer(p,a,b) (p)->lpVtbl->DuplicateSoundBuffer(p,a,b)
164 #endif
166 /*****************************************************************************
167 * IDsDriverBuffer interface
169 #define INTERFACE IDsDriverBuffer
170 DECLARE_INTERFACE_(IDsDriverBuffer,IUnknown)
172 /*** IUnknown methods ***/
173 STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
174 STDMETHOD_(ULONG,AddRef)(THIS) PURE;
175 STDMETHOD_(ULONG,Release)(THIS) PURE;
176 /*** IDsDriverBuffer methods ***/
177 STDMETHOD(Lock)(THIS_ LPVOID *ppvAudio1,LPDWORD pdwLen1,LPVOID *pdwAudio2,LPDWORD pdwLen2,DWORD dwWritePosition,DWORD dwWriteLen,DWORD dwFlags) PURE;
178 STDMETHOD(Unlock)(THIS_ LPVOID pvAudio1,DWORD dwLen1,LPVOID pvAudio2,DWORD dwLen2) PURE;
179 STDMETHOD(SetFormat)(THIS_ LPWAVEFORMATEX pwfxToSet) PURE;
180 STDMETHOD(SetFrequency)(THIS_ DWORD dwFrequency) PURE;
181 STDMETHOD(SetVolumePan)(THIS_ PDSVOLUMEPAN pDsVolumePan) PURE;
182 STDMETHOD(SetPosition)(THIS_ DWORD dwNewPosition) PURE;
183 STDMETHOD(GetPosition)(THIS_ LPDWORD lpdwCurrentPlayCursor,LPDWORD lpdwCurrentWriteCursor) PURE;
184 STDMETHOD(Play)(THIS_ DWORD dwReserved1,DWORD dwReserved2,DWORD dwFlags) PURE;
185 STDMETHOD(Stop)(THIS) PURE;
187 #undef INTERFACE
189 #if !defined (__cplusplus) || defined(CINTERFACE)
190 /*** IUnknown methods ***/
191 #define IDsDriverBuffer_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
192 #define IDsDriverBuffer_AddRef(p) (p)->lpVtbl->AddRef(p)
193 #define IDsDriverBuffer_Release(p) (p)->lpVtbl->Release(p)
194 /*** IDsDriverBuffer methods ***/
195 #define IDsDriverBuffer_Lock(p,a,b,c,d,e,f,g) (p)->lpVtbl->Lock(p,a,b,c,d,e,f,g)
196 #define IDsDriverBuffer_Unlock(p,a,b,c,d) (p)->lpVtbl->Unlock(p,a,b,c,d)
197 #define IDsDriverBuffer_SetFormat(p,a) (p)->lpVtbl->SetFormat(p,a)
198 #define IDsDriverBuffer_SetFrequency(p,a) (p)->lpVtbl->SetFrequency(p,a)
199 #define IDsDriverBuffer_SetVolumePan(p,a) (p)->lpVtbl->SetVolumePan(p,a)
200 #define IDsDriverBuffer_SetPosition(p,a) (p)->lpVtbl->SetPosition(p,a)
201 #define IDsDriverBuffer_GetPosition(p,a,b) (p)->lpVtbl->GetPosition(p,a,b)
202 #define IDsDriverBuffer_Play(p,a,b,c) (p)->lpVtbl->Play(p,a,b,c)
203 #define IDsDriverBuffer_Stop(p) (p)->lpVtbl->Stop(p)
204 #endif
206 /*****************************************************************************
207 * IDsDriverPropertySet interface
209 #define INTERFACE IDsDriverPropertySet
210 DECLARE_INTERFACE_(IDsDriverPropertySet,IUnknown)
212 /*** IUnknown methods ***/
213 STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
214 STDMETHOD_(ULONG,AddRef)(THIS) PURE;
215 STDMETHOD_(ULONG,Release)(THIS) PURE;
216 /*** IDsDriverPropertySet methods ***/
217 STDMETHOD(Get)(THIS_ PDSPROPERTY pDsProperty,LPVOID pPropertyParams,ULONG cbPropertyParams,LPVOID pPropertyData,ULONG cbPropertyData,PULONG pcbReturnedData) PURE;
218 STDMETHOD(Set)(THIS_ PDSPROPERTY pDsProperty,LPVOID pPropertyParams,ULONG cbPropertyParams,LPVOID pPropertyData,ULONG cbPropertyData) PURE;
219 STDMETHOD(QuerySupport)(THIS_ REFGUID PropertySetId,ULONG PropertyId,PULONG pSupport) PURE;
221 #undef INTERFACE
223 #if !defined (__cplusplus) || defined(CINTERFACE)
224 /*** IUnknown methods ***/
225 #define IDsDriverPropertySet_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
226 #define IDsDriverPropertySet_AddRef(p) (p)->lpVtbl->AddRef(p)
227 #define IDsDriverPropertySet_Release(p) (p)->lpVtbl->Release(p)
228 /*** IDsDriverPropertySet methods ***/
229 #define IDsDriverPropertySet_Get(p,a,b,c,d,e,f) (p)->lpVtbl->Get(p,a,b,c,d,e,f)
230 #define IDsDriverPropertySet_Set(p,a,b,c,d,e) (p)->lpVtbl->Set(p,a,b,c,d,e)
231 #define IDsDriverPropertySet_QuerySupport(p,a,b,c) (p)->lpVtbl->QuerySupport(p,a,b,c)
232 #endif
234 /* Defined property sets */
235 DEFINE_GUID(DSPROPSETID_DirectSound3DListener, 0x6D047B40, 0x7AF9, 0x11D0, 0x92, 0x94, 0x44, 0x45, 0x53, 0x54, 0x0, 0x0);
236 typedef enum
238 DSPROPERTY_DIRECTSOUND3DLISTENER_ALL,
239 DSPROPERTY_DIRECTSOUND3DLISTENER_POSITION,
240 DSPROPERTY_DIRECTSOUND3DLISTENER_VELOCITY,
241 DSPROPERTY_DIRECTSOUND3DLISTENER_ORIENTATION,
242 DSPROPERTY_DIRECTSOUND3DLISTENER_DISTANCEFACTOR,
243 DSPROPERTY_DIRECTSOUND3DLISTENER_ROLLOFFFACTOR,
244 DSPROPERTY_DIRECTSOUND3DLISTENER_DOPPLERFACTOR,
245 DSPROPERTY_DIRECTSOUND3DLISTENER_BATCH,
246 DSPROPERTY_DIRECTSOUND3DLISTENER_ALLOCATION
247 } DSPROPERTY_DIRECTSOUND3DLISTENER;
249 DEFINE_GUID(DSPROPSETID_DirectSound3DBuffer, 0x6D047B41, 0x7AF9, 0x11D0, 0x92, 0x94, 0x44, 0x45, 0x53, 0x54, 0x0, 0x0);
250 typedef enum
252 DSPROPERTY_DIRECTSOUND3DBUFFER_ALL,
253 DSPROPERTY_DIRECTSOUND3DBUFFER_POSITION,
254 DSPROPERTY_DIRECTSOUND3DBUFFER_VELOCITY,
255 DSPROPERTY_DIRECTSOUND3DBUFFER_CONEANGLES,
256 DSPROPERTY_DIRECTSOUND3DBUFFER_CONEORIENTATION,
257 DSPROPERTY_DIRECTSOUND3DBUFFER_CONEOUTSIDEVOLUME,
258 DSPROPERTY_DIRECTSOUND3DBUFFER_MINDISTANCE,
259 DSPROPERTY_DIRECTSOUND3DBUFFER_MAXDISTANCE,
260 DSPROPERTY_DIRECTSOUND3DBUFFER_MODE
261 } DSPROPERTY_DIRECTSOUND3DBUFFER;
263 DEFINE_GUID(DSPROPSETID_DirectSoundSpeakerConfig, 0x6D047B42, 0x7AF9, 0x11D0, 0x92, 0x94, 0x44, 0x45, 0x53, 0x54, 0x0, 0x0);
264 typedef enum
266 DSPROPERTY_DIRECTSOUNDSPEAKERCONFIG_SPEAKERCONFIG
267 } DSPROPERTY_DIRECTSOUNDSPEAKERCONFIG;
269 /*****************************************************************************
270 * IDsDriverNotify interface
272 #define INTERFACE IDsDriverNotify
273 DECLARE_INTERFACE_(IDsDriverNotify,IUnknown)
275 /*** IUnknown methods ***/
276 STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
277 STDMETHOD_(ULONG,AddRef)(THIS) PURE;
278 STDMETHOD_(ULONG,Release)(THIS) PURE;
279 /*** IDsDriverNotify methods ***/
280 STDMETHOD(SetNotificationPositions)(THIS_ DWORD dwPositionNotifies,LPCDSBPOSITIONNOTIFY pcPositionNotifies) PURE;
282 #undef INTERFACE
284 #if !defined (__cplusplus) || defined(CINTERFACE)
285 /*** IUnknown methods ***/
286 #define IDsDriverNotify_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
287 #define IDsDriverNotify_AddRef(p) (p)->lpVtbl->AddRef(p)
288 #define IDsDriverNotify_Release(p) (p)->lpVtbl->Release(p)
289 /*** IDsDriverNotify methods ***/
290 #define IDsDriverNotify_SetNotificationPositions(p,a,b) (p)->lpVtbl->SetNotificationPositions(p,a,b)
291 #endif
293 /*****************************************************************************
294 * IDsCaptureDriver interface
296 #define INTERFACE IDsCaptureDriver
297 DECLARE_INTERFACE_(IDsCaptureDriver,IUnknown)
299 /*** IUnknown methods ***/
300 STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
301 STDMETHOD_(ULONG,AddRef)(THIS) PURE;
302 STDMETHOD_(ULONG,Release)(THIS) PURE;
303 /*** IDsCaptureDriver methods ***/
304 STDMETHOD(GetDriverDesc)(THIS_ PDSDRIVERDESC pDsDriverDesc) PURE;
305 STDMETHOD(Open)(THIS) PURE;
306 STDMETHOD(Close)(THIS) PURE;
307 STDMETHOD(GetCaps)(THIS_ PDSCDRIVERCAPS pDsDrvCaps) PURE;
308 STDMETHOD(CreateCaptureBuffer)(THIS_ LPWAVEFORMATEX pwfx,DWORD dwFlags,DWORD dwCardAddress,LPDWORD pdwcbBufferSize,LPBYTE *ppbBuffer,LPVOID *ppvObj) PURE;
310 #undef INTERFACE
312 #if !defined (__cplusplus) || defined(CINTERFACE)
313 /*** IUnknown methods ***/
314 #define IDsCaptureDriver_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
315 #define IDsCaptureDriver_AddRef(p) (p)->lpVtbl->AddRef(p)
316 #define IDsCaptureDriver_Release(p) (p)->lpVtbl->Release(p)
317 /*** IDsCaptureDriver methods ***/
318 #define IDsCaptureDriver_GetDriverDesc(p,a) (p)->lpVtbl->GetDriverDesc(p,a)
319 #define IDsCaptureDriver_Open(p) (p)->lpVtbl->Open(p)
320 #define IDsCaptureDriver_Close(p) (p)->lpVtbl->Close(p)
321 #define IDsCaptureDriver_GetCaps(p,a) (p)->lpVtbl->GetCaps(p,a)
322 #define IDsCaptureDriver_CreateCaptureBuffer(p,a,b,c,d,e,f) (p)->lpVtbl->CreateCaptureBuffer(p,a,b,c,d,e,f)
323 #endif
325 /*****************************************************************************
326 * IDsCaptureDriverBuffer interface
328 #define INTERFACE IDsCaptureDriverBuffer
329 DECLARE_INTERFACE_(IDsCaptureDriverBuffer,IUnknown)
331 /*** IUnknown methods ***/
332 STDMETHOD_(HRESULT,QueryInterface)(THIS_ REFIID riid, void** ppvObject) PURE;
333 STDMETHOD_(ULONG,AddRef)(THIS) PURE;
334 STDMETHOD_(ULONG,Release)(THIS) PURE;
335 /*** IDsCaptureDriverBuffer methods ***/
336 STDMETHOD(Lock)(THIS_ LPVOID *ppvAudio1,LPDWORD pdwLen1,LPVOID *ppvAudio2,LPDWORD pdwLen2,DWORD dwWritePosition,DWORD dwWriteLen,DWORD dwFlags) PURE;
337 STDMETHOD(Unlock)(THIS_ LPVOID pvAudio1,DWORD dwLen1,LPVOID pvAudio2,DWORD dwLen2) PURE;
338 STDMETHOD(SetFormat)(THIS_ LPWAVEFORMATEX pwfxToSet) PURE;
339 STDMETHOD(GetPosition)(THIS_ LPDWORD lpdwCurrentPlayCursor,LPDWORD lpdwCurrentWriteCursor) PURE;
340 STDMETHOD(GetStatus)(THIS_ LPDWORD lpdwStatus) PURE;
341 STDMETHOD(Start)(THIS_ DWORD dwFlags) PURE;
342 STDMETHOD(Stop)(THIS) PURE;
344 #undef INTERFACE
346 #if !defined (__cplusplus) || defined(CINTERFACE)
347 /*** IUnknown methods ***/
348 #define IDsCaptureDriverBuffer_QueryInterface(p,a,b) (p)->lpVtbl->QueryInterface(p,a,b)
349 #define IDsCaptureDriverBuffer_AddRef(p) (p)->lpVtbl->AddRef(p)
350 #define IDsCaptureDriverBuffer_Release(p) (p)->lpVtbl->Release(p)
351 /*** IDsCaptureDriverBuffer methods ***/
352 #define IDsCaptureDriverBuffer_Lock(p,a,b,c,d,e,f,g) (p)->lpVtbl->Lock(p,a,b,c,d,e,f,g)
353 #define IDsCaptureDriverBuffer_Unlock(p,a,b,c,d) (p)->lpVtbl->Unlock(p,a,b,c,d)
354 #define IDsCaptureDriverBuffer_SetFormat(p,a) (p)->lpVtbl->SetFormat(p,a)
355 #define IDsCaptureDriverBuffer_GetPosition(p,a,b) (p)->lpVtbl->GetPosition(p,a,b)
356 #define IDsCaptureDriverBuffer_GetStatus(p,a) (p)->lpVtbl->GetStatus(p,a)
357 #define IDsCaptureDriverBuffer_Start(p,a) (p)->lpVtbl->Start(p,a)
358 #define IDsCaptureDriverBuffer_Stop(p) (p)->lpVtbl->Stop(p)
359 #endif
361 #ifdef __cplusplus
362 } /* extern "C" */
363 #endif
365 #endif /* __WINE_DSDRIVER_H */