KSAUDIO_MIC_ARRAY_GEOMETRY-Struktur (ksmedia.h)
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) |