DirectSoundCaptureEnumerate

HRESULT WINAPI DirectSoundCaptureEnumerate( LPDSENUMCALLBACK lpDSEnumCallback, LPVOID lpContext );

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

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

Аргументы

0. lpDSEnumCallback — указатель на функцию DSEnumCallback, вызываемую для каждого объекта DirectSoundCapture, установленного в системе.

1. lpContext — указатель на определённый пользователем контекст, передаваемый функции обратного вызова, создающей список устройств при каждом вызове функции.

Примечание

Функция DirectSoundCaptureEnumerate создаёт список установленных в системе драйверов DirectSoundCapture.

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

DirectSoundCreate

HRESULT WINAPI DirectSoundCreate( LPGUID lpGuid, LPDIRECTSOUND * ppDS, IUnknown FAR * pUnkOuter );

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

В случае успешного завершения возвращает значение DS_OK. В противном случае возвращаемое значение может принимать одно из следующих значений:

• DSERR_ALLOCATED — ресурс, например, уровень приоритета, уже предоставлен по другому запросу.

• DSERR_INVALIDPARAM — один или несколько аргументов метода имеют недопустимые значения.

• DSERR_NOAGGREGATION — объект не поддерживает агрегирование.

• DSERR_NODRIVER — отсутствует необходимый аудио драйвер.

• DSERR_OUTOFMEMORY — недостаточно памяти для выполнения требуемой операции.

Аргументы

0. lpGuid — указатель на глобально уникальный идентификатор (GUID) аудио устройства. Значение данного аргумента должно совпадать с одним из глобально уникальных идентификаторов, возвращённых функцией DirectSoundEnumerate, или NULL для устройства, используемого по умолчанию.

1. ppDS — указатель на объект DirectSound, создаваемый данной функцией.

2. pUnkOuter — используется при агрегации. Должен иметь нулевое значение.

Примечание

Функция DirectSoundCreate создаёт и инициализирует интерфейс IDirectSound. Первым методом, вызываемым в интерфейсе IDirectSound после его создания, должен быть IDirectSound::SetCooperativeLevel.

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

DirectSoundEnumerate

HRESULT WINAPI DirectSoundEnumerate( LPDSENUMCALLBACK pDSEnumCallback, LPVOID lpContext );

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

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

Аргументы

0. lpDSEnumCallback — указатель на функцию DSEnumCallback, вызываемую для каждого объекта DirectSound, установленного в системе.

1. lpContext — указатель на определённый пользователем контекст, передаваемый функции обратного вызова, создающей список устройств при каждом вызове функции.

Примечание

Функция DirectSoundEnumerate создаёт список установленных в системе драйверов DirectSound.

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