KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY
Свойство KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY используется в сочетании с KSPROPERTY_AUDIO_CHANNEL_CONFIG для реализации свойства Конфигурации динамиков DirectSound для трехмерного звука с аппаратным ускорением. Это необязательное свойство узлов DAC (KSNODETYPE_DAC) и трехмерных узлов (KSNODETYPE_3D_EFFECTS).
Сводная таблица использования
| Получить | Присвойте параметру | Назначение | Тип дескриптора свойства | Тип значения свойства |
|---|---|---|---|---|
Да |
Да |
Закрепление/фильтрация |
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, указывающий на успешное выполнение. В противном случае запрос возвращает соответствующий код состояния ошибки.
Комментарии
DirectSound рассматривает KSPROPERTY_AUDIO_STEREO_SPEAKER_GEOMETRY как свойство фильтра на узле DAC и как свойство закрепления на трехмерном узле.
Дополнительные сведения см. в разделе Параметры DirectSound Speaker-Configuration.
Требования
Заголовок |
Ksmedia.h (включая Ksmedia.h) |