KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY

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。

如果 KSP_PIN 结构的 PinId 成员指示的引脚不支持麦克风阵列请求,则属性请求将返回 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 中处理麦克风阵列的详细信息,请参阅以下资源:

麦克风阵列几何属性

Windows 中的麦克风阵列支持(白皮书)

要求

标头

Ksmedia.h(包括 Ksmedia.h)

另请参阅

KSAUDIO_MIC_ARRAY_GEOMETRY

KSP_PIN