共用方式為


KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY

KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY 屬性會指定麥克風陣列的幾何。

使用量摘要資料表

使用量摘要資料表

Get

集合

目標

屬性描述項類型

屬性值類型

篩選

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