dlls/mmdevapi/mmdevapi.h

   1 /*
   2  * Copyright 2009 Maarten Lankhorst
   3  *
   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.
   8  *
   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.
  13  *
  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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  17  */
  18
  19 #ifndef __WINE_CONFIG_H
  20 # error You must include config.h to use this header
  21 #endif
  22
  23 extern HRESULT MMDevEnum_Create(REFIID riid, void **ppv) DECLSPEC_HIDDEN;
  24 extern void MMDevEnum_Free(void) DECLSPEC_HIDDEN;
  25
  26 extern HRESULT MMDevice_GetPropValue(const GUID *devguid, DWORD flow, REFPROPERTYKEY key, PROPVARIANT *pv) DECLSPEC_HIDDEN;
  27
  28 /* Changes to this enum must be synced in drivers. */
  29 enum _DriverPriority {
  30     Priority_Unavailable = 0, /* driver won't work */
  31     Priority_Low, /* driver may work, but unlikely */
  32     Priority_Neutral, /* driver makes no judgment */
  33     Priority_Preferred /* driver thinks it's correct */
  34 };
  35
  36 typedef struct _DriverFuncs {
  37     HMODULE module;
  38     WCHAR module_name[64];
  39     int priority;
  40
  41     /* Returns a "priority" value for the driver. Highest priority wins.
  42      * If multiple drivers think they are valid, they will return a
  43      * priority value reflecting the likelihood that they are actually
  44      * valid. See enum _DriverPriority. */
  45     int WINAPI (*pGetPriority)(void);
  46
  47     /* ids gets an array of human-friendly endpoint names
  48      * keys gets an array of driver-specific stuff that is used
  49      *   in GetAudioEndpoint to identify the endpoint
  50      * it is the caller's responsibility to free both arrays, and
  51      *   all of the elements in both arrays with HeapFree() */
  52     HRESULT WINAPI (*pGetEndpointIDs)(EDataFlow flow, WCHAR ***ids,
  53             void ***keys, UINT *num, UINT *default_index);
  54     HRESULT WINAPI (*pGetAudioEndpoint)(void *key, IMMDevice *dev,
  55             EDataFlow dataflow, IAudioClient **out);
  56     HRESULT WINAPI (*pGetAudioSessionManager)(IMMDevice *device,
  57             IAudioSessionManager2 **out);
  58 } DriverFuncs;
  59
  60 extern DriverFuncs drvs DECLSPEC_HIDDEN;
  61
  62 typedef struct MMDevice {
  63     IMMDevice IMMDevice_iface;
  64     IMMEndpoint IMMEndpoint_iface;
  65     LONG ref;
  66
  67     CRITICAL_SECTION crst;
  68
  69     EDataFlow flow;
  70     DWORD state;
  71     GUID devguid;
  72     WCHAR *drv_id;
  73     void *key;
  74 } MMDevice;
  75
  76 extern HRESULT AudioClient_Create(MMDevice *parent, IAudioClient **ppv) DECLSPEC_HIDDEN;
  77 extern HRESULT AudioEndpointVolume_Create(MMDevice *parent, IAudioEndpointVolume **ppv) DECLSPEC_HIDDEN;