AfxGetInstanceHandle

HINSTANCE AfxGetInstanceHandle( );

Возвращаемое значение

Дескриптор HINSTANCE текущей копии приложения. Если вызов данной функции произошёл из библиотеки динамической компоновки, связанной с версией USRDLL библиотеки MFC, возвращается дескриптор HINSTANCE данной библиотеки динамической компоновки (DLL).

Примечание

Данная функция позволяет получить дескриптор текущей копии приложения. Функция AfxGetInstanceHandle всегда возвращает объект HINSTANCE исполняемого в настоящее время файла (.exe), кроме случая, когда она вызывается из библиотеки динамической компоновки, связанной с версией USRDLL библиотеки MFC. В этом случае она возвращает дескриптор HINSTANCE данной библиотеки динамической компоновки.

AuxGetDevCaps

MMRESULT auxGetDevCaps( UINT uDeviceID, LPAUXCAPS lpCaps, UINT cbCaps );

Возвращаемое значение

В случае успешного завершения возвращает значение MMSYSERR_NOERROR. В противном случае возвращает значение:

• MMSYSERR_BADDEVICEID — указанный идентификатор устройства имеет значение, выходящее за допустимый диапазон.

Аргументы

0. uDeviceID — идентификатор вспомогательного устройства вывода аудио информации, параметры которого следует получить. В данном аргументе может передаваться допустимое значение идентификатора устройства или константа AUX_MAPPER. В последнем случае функция возвращает значение ошибки, если не установлена система выбора вспомогательных аудио устройств.

1. lpCaps — указатель на объект структуры AUXCAPS, в которую будет записана информация о возможностях устройства.

2. cbCaps — размер объекта структуры AUXCAPS в байтах.

Примечание

Функция auxGetDevCaps позволяет получить информацию о возможностях вспомогательного устройства вывода аудио информации.

Идентификатор устройства, передаваемый в аргументе uDeviceID, может принимать любые значения от нуля до величины, на единицу меньшей числа устройств, установленных в системе. Кроме того, в нём может использоваться константа AUX_MAPPER. Для определения числа установленных в системе вспомогательных устройств вывода аудио информации используется функция auxGetNumDevs.

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.

AuxGetNumDevs

UINT auxGetNumDevs(VOID);

Возвращаемое значение

Возвращает количество устройств. Нулевое возвращаемое значение указывает на отсутствие устройств в системе или на возникновение ошибки.

Примечание

Функция auxGetNumDevs позволяет получить число вспомогательных устройств вывода аудио информации, установленных в системе.

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.

AuxGetVolume

MMRESULT auxGetVolume( UINT uDeviceID, LPDWORD lpdwVolume );

Возвращаемое значение

В случае успешного завершения возвращает значение MMSYSERR_NOERROR. В противном случае возвращает значение:

• MMSYSERR_BADDEVICEID — указанный идентификатор устройства имеет значение, выходящее за допустимый диапазон.

Аргументы

0. uDeviceID — идентификатор вспомогательного устройства вывода аудио информации, уровень воспроизведения которого следует получить.

1. lpdwVolume — указатель на переменную, в которую будет записано текущее значение уровня воспроизведения. Младшее слово этой переменной содержит уровень воспроизведения по левому каналу, а старшее слово — по правому каналу. Значение 0xFFFF соответствует максимальному уровню воспроизведения, а значение 0x0000 — тишине.

2. Если устройство не допускает раздельной регулировки по левому и правому каналам, уровень воспроизведения монофонического сигнала будет содержаться в младшем слове данной переменной.

3. Информация возвращается в полном 16-битовом формате, используемом в функции auxSetVolume независимо от того, какой формат уровня воспроизведения используется в устройстве.

Примечание

Функция auxGetVolume позволяет получить текущее значение уровня воспроизведения указанного вспомогательного устройства вывода аудио информации.

Не все устройства допускают регулировку уровня воспроизведения. Для определения того, поддерживает ли данное устройство регулировку уровня воспроизведения, следует вызвать функцию auxGetDevCaps и проверить значение флага AUXCAPS_VOLUME в переменной dwSupport возвращаемого данной функцией объекта структуры AUXCAPS.

Для определения того, допускает ли данное устройство раздельную регулировку уровня воспроизведения по левому и правому каналам, следует вызвать функцию auxGetDevCaps и проверить значение флага AUXCAPS_LRVOLUME в переменной dwSupport возвращаемого данной функцией объекта структуры AUXCAPS.

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.