KSAUDIO_MIC_ARRAY_GEOMETRY-Struktur (ksmedia.h)

Artikel
02/26/2024

Die KSAUDIO_MIC_ARRAY_GEOMETRY-Struktur gibt den Typ und die Geometrie des Mikrofonarrays an. Das UsNumberOfMicrophones-Element gibt die Anzahl der Mikrofone im physischen Array an. Das KsMicCoord-Element ist eine Variable vom Typ KSAUDIO_MICROPHONE_COORDINATES und ein Array von Strukturen. Die Anzahl der Einträge in diesem Array wird durch den Wert des Members usNumberOfMicrophones angegeben.

Syntax

typedef struct {
  USHORT                         usVersion;
  USHORT                         usMicArrayType;
  SHORT                          wVerticalAngleBegin;
  SHORT                          wVerticalAngleEnd;
  SHORT                          wHorizontalAngleBegin;
  SHORT                          wHorizontalAngleEnd;
  USHORT                         usFrequencyBandLo;
  USHORT                         usFrequencyBandHi;
  USHORT                         usNumberOfMicrophones;
  KSAUDIO_MICROPHONE_COORDINATES KsMicCoord[1];
} KSAUDIO_MIC_ARRAY_GEOMETRY, *PKSAUDIO_MIC_ARRAY_GEOMETRY;

Member

usVersion

Gibt die Versionsnummer der KSAUDIO_MIC_ARRAY_GEOMETRY-Struktur an. Dieses Element ist ein BCD-Wert und derzeit auf 0x0100 festgelegt, was eine Versionsnummer von 1.0 darstellt.

usMicArrayType

Gibt den Typ des verwendeten Mikrofonarrays an. Bei diesem Member kann es sich um einen beliebigen der in der folgenden Tabelle gezeigten KSMICARRAY_MICARRAYTYPE Enumerationswerte handeln.

Wert	Mikrofonarraytyp
KSMICARRAY_MICARRAYTYPE_LINEAR	Linear
KSMICARRAY_MICARRAYTYPE_PLANAR	Planar
KSMICARRAY_MICARRAYTYPE_3D	3D

wVerticalAngleBegin

Gibt den vertikalen Winkel des Beginns der Arbeitslautstärke des Mikrofonarrays an.

wVerticalAngleEnd

Gibt den vertikalen Winkel des Endes der Arbeitslautstärke des Mikrofonarrays an.

wHorizontalAngleBegin

Arbeitsvolume HorizontalAngle Begin

wHorizontalAngleEnd

HorizontalAngle-Ende des Arbeitsvolumes

usFrequencyBandLo

Gibt das untere Ende des Frequenzbereichs für das Mikrofonarray an.

usFrequencyBandHi

Gibt das hohe Ende des Frequenzbereichs für das Mikrofonarray an.

usNumberOfMicrophones

Gibt die Anzahl der Mikrofone im Mikrofonarray an.

KsMicCoord[1]

Gibt das Array von KSAUDIO_MICROPHONE_COORDINATES Strukturen an, das die Standorte der Mikrofone im Array enthält.

Hinweise

Alle Winkelwerte werden in Einheiten von 1/10000stel eines Bogens ausgedrückt. Beispielsweise wird 3,1416 Bogenmaße als 31416 Einheiten ausgedrückt. Zulässige Werte reichen von -31416 bis 31416 Einheiten.

Alle Koordinatenwerte werden in Millimetern ausgedrückt. Zulässige Werte reichen von -32768 bis einschließlich 32767.

Die Frequenzwerte werden in Hertz (Hz) ausgedrückt.

Weitere Informationen zum Verarbeiten eines Mikrofonarrays in Windows finden Sie im Whitepaper Mikrofonarrayunterstützung in Windows .

Anforderungen

Anforderung	Wert
Header	ksmedia.h (include Ksmedia.h)

Weitere Informationen

KSAUDIO_MICROPHONE_COORDINATES

Freigeben über