video-pc/libs/Recorder/AecKsBinder.h

//-------------------------------------------------------------------------
// File: AecKsBinder.h
// 
// Desciption: Definition of audio devices binding functions 
//
// Copyright (c) 2004-2006, Microsoft Corporation. All rights reserved.
//---------------------------------------------------------------------------

#ifndef _AEC_KSBINDER_H_
#define _AEC_KSBINDER_H_

#include <atlbase.h>
#include <ATLComCli.h>
#include <audioclient.h>
#include <MMDeviceApi.h>
#include <AudioEngineEndPoint.h>
#include <DeviceTopology.h>
#include <EndpointVolume.h>

typedef struct 
{
    KSPROPERTY KsProperty;
    BOOLEAN bEndpointFlag;
    ULONG ulEntityId;
    union {
         ULONG ulEndpoint;
         ULONG ulInterface;
    };
    ULONG ulOffset;
} USBAUDIO_MEMORY_PROPERTY, *PUSBAUDIO_MEMORY_PROPERTY;

static const GUID USB_AUDIO_PROP_SET_GUID = 
     {0xC3FA16D7, 0x274E, 0x4f2b, 
     {0xA6, 0x3B, 0xD5, 0xE1, 0x09, 0x55, 0xFA, 0x27}};
const DWORD USBAUDIO_PROPERTY_GETSET_MEM = 0;

#define MAX_STR_LEN 512
typedef struct
{
    TCHAR szDeviceName[MAX_STR_LEN];
	TCHAR szDeviceID[MAX_STR_LEN];
    bool bIsMicArrayDevice;
} AUDIO_DEVICE_INFO, *PAUDIO_DEVICE_INFO;
    

HRESULT GetDeviceNum(EDataFlow eDataFlow, UINT &uDevCount);

__inline HRESULT GetRenderDeviceNum(UINT &uDevCount)
{ return GetDeviceNum(eRender, uDevCount); }

__inline HRESULT GetCaptureDeviceNum(UINT &uDevCount)
{ return GetDeviceNum(eCapture, uDevCount); }


HRESULT EnumDevice(
    EDataFlow eDataFlow, 
    UINT  uNumElements,
    AUDIO_DEVICE_INFO *pDevicInfo);

__inline HRESULT EnumRenderDevice(UINT  uNumElements, AUDIO_DEVICE_INFO *pDevicInfo) 
    { return EnumDevice(eRender, uNumElements, pDevicInfo); }

__inline HRESULT EnumCaptureDevice(UINT  uNumElements, AUDIO_DEVICE_INFO *pDevicInfo) 
    { return EnumDevice(eCapture, uNumElements, pDevicInfo); }


HRESULT DeviceBindTo(
        EDataFlow eDataFlow,        // eCapture or eRender
        INT uDevIdx,                // Device Index. USE_DEFAULT_DEVICE - use default device. 
        IAudioClient **ppAudioClient,    // pointer pointer to IAudioClient interface
        IAudioEndpointVolume **ppEndpointVolume,
        WCHAR** ppszEndpointDeviceId   // Device ID. Need to be freed in caller with CoTaskMemoryFree
);

__inline HRESULT CaptureDeviceBindTo(
        INT uDevIdx, 
        IAudioClient **ppAudioClient,    // pointer pointer to IAudioClient interface
        IAudioEndpointVolume **ppEndpointVolume,
        WCHAR** ppszEndpointDeviceId)
{
    return DeviceBindTo(eCapture, uDevIdx, ppAudioClient, ppEndpointVolume, ppszEndpointDeviceId);
}

__inline HRESULT RenderDeviceBindTo(
        INT uDevIdx, 
        IAudioClient **ppAudioClient,    // pointer pointer to IAudioClient interface
        IAudioEndpointVolume **ppEndpointVolume,
        WCHAR** ppszEndpointDeviceId)
{
    return DeviceBindTo(eRender, uDevIdx, ppAudioClient, ppEndpointVolume, ppszEndpointDeviceId);
}

HRESULT DeviceIsMicArray(wchar_t szDeviceId[], bool& bIsMicArray);

HRESULT EndpointIsMicArray(IMMDevice* pEndpoint, bool& isMicrophoneArray);

HRESULT GetJackSubtypeForEndpoint(IMMDevice* pEndpoint, GUID* pgSubtype);

__checkReturn HRESULT GetInputJack(IMMDevice* pDevice, CComPtr<IPart>& spPart);

HRESULT GetMicArrayGeometry(wchar_t szDeviceId[], KSAUDIO_MIC_ARRAY_GEOMETRY** ppGeometry, ULONG& cbSize);

#endif //_AEC_KSBINDER_H_