KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY

Статья
06/14/2023

Свойство KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY указывает геометрию массива микрофонов.

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

Получить	Присвойте параметру	Назначение	Тип дескриптора свойства	Тип значения свойства
Да	Нет	Фильтр	KSP_PIN	KSAUDIO_MIC_ARRAY_GEOMETRY

Значение свойства (данные операции) имеет тип KSAUDIO_MIC_ARRAY_GEOMETRY. Дополнительные сведения см. в определении структуры KSAUDIO_MIC_ARRAY_GEOMETRY .

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

Запрос свойства KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY возвращает STATUS_SUCCESS после успешного выполнения запроса.

Если контакт, указанный элементом PinId структуры KSP_PIN , не поддерживает запрос массива микрофонов, запрос свойства вернет STATUS_NOT_SUPPORTED.

Если размер буфера запроса равен нулю, запрос свойства вернет состояние STATUS_BUFFER_OVERFLOW. Кроме того, запрос будет использовать блок состояния возврата, чтобы указать размер структуры KSAUDIO_MIC_ARRAY_GEOMETRY, поддерживаемой закреплением.

Если размер буфера запроса равен любому размеру буфера, который слишком мал для размещения возвращаемой структуры, запрос возвращает состояние STATUS_BUFFER_TOO_SMALL. Затем запрос будет использовать возвращаемый блок состояния, чтобы указать размер структуры KSAUDIO_MIC_ARRAY_GEOMETRY , поддерживаемой закреплением.

Свойство KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY поддерживает только запросы KSPROPERTY_TYPE_GET. Чтобы клиент определил правильный размер буфера, необходимый для размещения всей геометрической структуры, он должен сначала выполнить запрос с нулевым размером буфера. Затем клиент может использовать значение, возвращаемое в блоке состояния, чтобы правильно задать размер буфера, а затем выполнить другой запрос свойства с буфером правильного размера.

Дополнительные сведения об обработке массива микрофонов в Windows см. в следующих ресурсах:

Свойство geometry массива микрофона

Поддержка массива микрофонов в Windows (технический документ)