KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY

Artikel
06/15/2023

Die KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY-Eigenschaft gibt die Geometrie des Mikrofonarrays an.

Nutzungszusammenfassungstabelle

Herunterladen	Set	Ziel	Eigenschaftendeskriptortyp	Eigenschaftswerttyp
Ja	Nein	Filter	KSP_PIN	KSAUDIO_MIC_ARRAY_GEOMETRY

Der Eigenschaftswert (Vorgangsdaten) ist vom Typ KSAUDIO_MIC_ARRAY_GEOMETRY. Ausführliche Informationen finden Sie in der Definition der KSAUDIO_MIC_ARRAY_GEOMETRY-Struktur .

Rückgabewert

Eine KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY-Eigenschaftsanforderung gibt nach erfolgreichem Abschluss der Anforderung einen STATUS_SUCCESS zurück.

Wenn der durch den PinId-Member der KSP_PIN-Struktur angegebene Pin keine Mikrofonarrayanforderung unterstützt, gibt die Eigenschaftenanforderung STATUS_NOT_SUPPORTED zurück.

Wenn die Puffergröße der Anforderung auf null festgelegt ist, gibt die Eigenschaftenanforderung einen STATUS_BUFFER_OVERFLOW status zurück. Darüber hinaus verwendet die Anforderung den Rückgabeblock status, um die Größe der vom Pin unterstützten KSAUDIO_MIC_ARRAY_GEOMETRY-Struktur anzugeben.

Wenn die Puffergröße der Anforderung auf eine Puffergröße festgelegt ist, die für die zurückgegebene Struktur zu klein ist, gibt die Anforderung eine status von STATUS_BUFFER_TOO_SMALL zurück. Die Anforderung verwendet dann den Rückgabeblock status, um die Größe der KSAUDIO_MIC_ARRAY_GEOMETRY-Struktur anzugeben, die von der Pin unterstützt wird.

Bemerkungen

Die KSPROPERTY_AUDIO_MIC_ARRAY_GEOMETRY-Eigenschaft unterstützt nur KSPROPERTY_TYPE_GET Anforderungen. Damit der Client die richtige Größe des Puffers ermitteln kann, der für die gesamte Geometriestruktur erforderlich ist, muss er zuerst die Anforderung mit einer Puffergröße von null ausführen. Der Client kann dann den im status-Block zurückgegebenen Wert verwenden, um die Puffergröße richtig festzulegen, und dann eine weitere Eigenschaftsanforderung mit dem Puffer mit der korrekten Größe ausführen.

Weitere Informationen zum Verarbeiten eines Mikrofonarrays in Windows finden Sie in den folgenden Ressourcen:

Geometry-Eigenschaft des Mikrofonarrays

Unterstützung des Mikrofonarrays in Windows (Whitepaper)