KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY

Статья
06/15/2023

Свойство KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY используется в сочетании с KSPROPERTY_AUDIO_CHANNEL_CONFIG для реализации свойства Конфигурации динамиков DirectSound для трехмерного звука с аппаратным ускорением. Это необязательное свойство узлов DAC (KSNODETYPE_DAC) и трехмерных узлов (KSNODETYPE_3D_EFFECTS).

Сводная таблица использования

Получить	Присвойте параметру	Назначение	Тип дескриптора свойства	Тип значения свойства
Да	Да	Закрепление/фильтрация	KSNODEPROPERTY	LONG

Значение свойства (данные операции) имеет тип LONG и указывает геометрию говорящего. Для этого значения можно задать одну из следующих констант, которые определены в файле заголовка Ksmedia.h:

KSAUDIO_STEREO_SPEAKER_GEOMETRY_HEADPHONES
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MIN
KSAUDIO_STEREO_SPEAKER_GEOMETRY_NARROW
KSAUDIO_STEREO_SPEAKER_GEOMETRY_WIDE
KSAUDIO_STEREO_SPEAKER_GEOMETRY_MAX

Приведенные выше параметры эквивалентны по значению (но не равны по значению) следующим значениям, которые используются методом IDirectSound::GetSpeakerConfig (см. документацию по Microsoft Windows SDK) и определяются в файле заголовка Dsound.h:

DSSPEAKER_HEADPHONE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MIN
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_NARROW
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_WIDE
DSSPEAKER_STEREO | DSSPEAKER_GEOMETRY_MAX

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

Запрос свойства KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY возвращает STATUS_SUCCESS, указывающий на успешное выполнение. В противном случае запрос возвращает соответствующий код состояния ошибки.