mmdevapi.h 2.78 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
/*
 * Copyright 2009 Maarten Lankhorst
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
 */

19 20 21 22
#ifndef __WINE_CONFIG_H
# error You must include config.h to use this header
#endif

23 24
extern HRESULT MMDevEnum_Create(REFIID riid, void **ppv) DECLSPEC_HIDDEN;
extern void MMDevEnum_Free(void) DECLSPEC_HIDDEN;
25

26

27 28 29 30 31 32 33 34
/* Changes to this enum must be synced in drivers. */
enum _DriverPriority {
    Priority_Unavailable = 0, /* driver won't work */
    Priority_Low, /* driver may work, but unlikely */
    Priority_Neutral, /* driver makes no judgment */
    Priority_Preferred /* driver thinks it's correct */
};

35 36
typedef struct _DriverFuncs {
    HMODULE module;
37
    WCHAR module_name[64];
38 39 40 41 42 43 44
    int priority;

    /* Returns a "priority" value for the driver. Highest priority wins.
     * If multiple drivers think they are valid, they will return a
     * priority value reflecting the likelihood that they are actually
     * valid. See enum _DriverPriority. */
    int WINAPI (*pGetPriority)(void);
45 46 47 48 49 50 51

    /* ids gets an array of human-friendly endpoint names
     * keys gets an array of driver-specific stuff that is used
     *   in GetAudioEndpoint to identify the endpoint
     * it is the caller's responsibility to free both arrays, and
     *   all of the elements in both arrays with HeapFree() */
    HRESULT WINAPI (*pGetEndpointIDs)(EDataFlow flow, WCHAR ***ids,
52
            GUID **guids, UINT *num, UINT *default_index);
53
    HRESULT WINAPI (*pGetAudioEndpoint)(void *key, IMMDevice *dev,
54
            IAudioClient **out);
55
    HRESULT WINAPI (*pGetAudioSessionManager)(IMMDevice *device,
56
            IAudioSessionManager2 **out);
57 58
} DriverFuncs;

59
extern DriverFuncs drvs DECLSPEC_HIDDEN;
60

61
typedef struct MMDevice {
62 63
    IMMDevice IMMDevice_iface;
    IMMEndpoint IMMEndpoint_iface;
64 65 66 67 68 69 70
    LONG ref;

    CRITICAL_SECTION crst;

    EDataFlow flow;
    DWORD state;
    GUID devguid;
71
    WCHAR *drv_id;
72
} MMDevice;
73

74 75
extern HRESULT AudioClient_Create(MMDevice *parent, IAudioClient **ppv) DECLSPEC_HIDDEN;
extern HRESULT AudioEndpointVolume_Create(MMDevice *parent, IAudioEndpointVolume **ppv) DECLSPEC_HIDDEN;
76 77

extern const WCHAR drv_keyW[] DECLSPEC_HIDDEN;