Поиск на сайте
Главная Журнал Форум Wiki DRKB Страны мира


Набор классов для работы с регулятором громкости.

Компилятор: Visual C++ 6

Автор: Alex Chmut

Скачать исходник - 15 Кб

Данный набор классов позволяет упростить разработку приложений, которые работают со звуком. Классы позволяют изменять и отслеживать такие значения как Output Master Volume, WaveOut Volume и Input (WaveIn) Volume.

Ниже представлены основные методы для всех классов (объявленные в IVolume.h):

bool    IsAvailable() - Доступно ли управление звуком
void    Enable() - Разрешаем данную громкость
void    Disable() - Блокируем данную громкость
DWORD   GetVolumeMetric() - Получаем степень детализации громкости
DWORD   GetMinimalVolume() - Узнаём минимальное значение
DWORD   GetMaximalVolume() - Узнаём максимальное значение
DWORD   GetCurrentVolume() - Узнаём текущее значение
void    SetCurrentVolume( DWORD dwValue ) - Устанавливаем громкость

А следующая функция позволяет послать уведомление для изменения громкости:

void    RegisterNotificationSink( PONMICVOULUMECHANGE, DWORD )

В исходнике присутствуют три класса: CVolumeOutMaster (VolumeOutMaster.h/cpp), CVolumeOutWave (VolumeOutWave.h/cpp) и CVolumeInXXX (VolumeInXXX.h/cpp). Использовать их можно следующим образом:

В StdAfx.h добавьте "mmSystem.h" и убадитесь, что присутствует ссылка на "winmm.lib" (#pragma comment(lib, "winmm.lib")). Затем, если Вы, например, захотите использовать регулятор громкости Output Mater, то добавьте "VolumeOutMaster.h", скажем, в StdAfx.h.

Файлы IVolume.h, VolumeInXXX.h, VolumeInXXX.cpp необходимо добавить как файлы проекта.

...
void CALLBACK MasterVolumeChanged( DWORD dwCurrentVolume, DWORD dwUserValue );
...
// Инициализация регулятора громкости
IVolume* pMasterVolume = (IVolume*)new CVolumeOutMaster();
if ( !pMasterVolume || !pMasterVolume->IsAvailable() )
{
        // обработка ошибки
}
pMasterVolume->Enable();
pMasterVolume->RegisterNotificationSink( MasterVolumeChanged, dwAnyUserValue );
...
pMasterVolume->SetCurrentVolume( dwVolumeToSet );
...
DWORD dwCurrentVolume = pMasterVolume->SetCurrentVolume();
...
void CALLBACK MasterVolumeChanged( DWORD dwCurrentVolume, DWORD dwUserValue )
{
        // обрабатываем изменения громкости
}
...

Класс CVolumeInXXX требует более детального объяснения. Чтобы манипулировать с громкостью входа (Input), необходимо передать номер входа в конструктор. Для этого в классе CVolumeInXXX присутствует статическая функция для определения входных линий:

bool    EnumerateInputLines( PINPUTLINEPROC, DWORD dwUserValue );

Допустим Вам необходимо работать с громкостью микрофона:

...
bool CALLBACK EnumInputLineProc( UINT uLineIndex, MIXERLINE* pLineInfo, DWORD dwUserValue );
...
// Инициализация
UINT uMicrophoneLineIndex = (UINT)-1;
if ( !CVolumeInXXX::EnumerateInputLines( EnumInputLineProc, (DWORD)&uMicrophoneLineIndex ) )
{
        // обработка ошибки
}
if ( uMicrophoneLineIndex == (UINT)-1 )
{
        // Ошибка: доступ к громкости микрофона не возможен.
}
IVolume* pMicrophoneVolume = (IVolume*)new CVolumeInXXX( uMicrophoneLineIndex );
if ( !pMicrophoneVolume || !pMicrophoneVolume->IsAvailable() )
{
        // обработка ошибки
}
// Далее приступаем к использованию pMicrophoneVolume для регуляции громкости
...
bool CALLBACK EnumInputLineProc( UINT uLineIndex, MIXERLINE* pLineInfo, DWORD dwUserValue )
{
        if ( pLineInfo->dwComponentType == MIXERLINE_COMPONENTTYPE_SRC_MICROPHONE )
        {
               *((UINT*)dwUserValue) = uLineIndex;
               return false;
        }
        return true;
}
...

Для большей производительности лучше ограничиться одним экземпляром класса для каждого регулятора громкости. Поэтому не стоит создавать много объектов CVolumeInXXX, лучше сделать доступным один экземпляр во всём коде.

 

 


Основные разделы сайта


 

Реклама