KSAUDIO_MIC_ARRAY_GEOMETRY Struktur (ksmedia.h)
Die KSAUDIO_MIC_ARRAY_GEOMETRY Struktur gibt den Typ und die Geometrie des Mikrofonarrays an. Die usNumberOfMicrophones Member gibt die Anzahl der Mikrofone im physischen Array an. Das KsMicCoord-Element ist eine Variable vom Typ KSAUDIO_MICROPHONE_COORDINATES und ist ein Array von Strukturen. Die Anzahl der Einträge in diesem Array wird durch den Wert des usNumberOfMicrophones Member 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;
Angehörige
usVersion
Gibt die Versionsnummer der KSAUDIO_MIC_ARRAY_GEOMETRY Struktur an. Dieses Element ist ein BCD-Wert und wird derzeit auf 0x0100 festgelegt, der eine Versionsnummer von 1,0 darstellt.
usMicArrayType
Gibt den Typ des verwendeten Mikrofonarrays an. Bei diesem Element kann es sich um einen der KSMICARRAY_MICARRAYTYPE Enumerationswerte handeln, die in der folgenden Tabelle angezeigt werden.
| Wert | Mikrofonarraytyp |
|---|---|
| KSMICARRAY_MICARRAYTYPE_LINEAR | Linear |
| KSMICARRAY_MICARRAYTYPE_PLANAR | Flach |
| KSMICARRAY_MICARRAYTYPE_3D | 3D |
wVerticalAngleBegin
Gibt den vertikalen Winkel des Anfangs der Arbeitslautstärke des Mikrofonarrays an.
wVerticalAngleEnd
Gibt den vertikalen Winkel des Endes der Arbeitslautstärke des Mikrofonarrays an.
wHorizontalAngleBegin
Arbeitsvolumen HorizontalAngle Begin
wHorizontalAngleEnd
Arbeitsvolume HorizontalAngle-Ende
usFrequencyBandLo
Gibt das niedrige Ende des Frequenzbereichs für das Mikrofonarray an.
usFrequencyBandHi
Gibt das High-End 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, die die Positionen der Mikrofone im Array enthalten.
Bemerkungen
Alle Winkelwerte werden in Einheiten von 1/10000th eines Bogenmaßs ausgedrückt. Beispielsweise wird 3,1416 Bogenmaß als 31416 Einheiten ausgedrückt. Zulässige Werte reichen von -31416 bis 31416 Einheiten.
Alle Koordinatenwerte werden in Millimeter ausgedrückt. Zulässige Werte reichen von -32768 bis einschließlich 32767.
Frequenzwerte werden in Hertz (Hz) ausgedrückt.
Weitere Informationen zum Verarbeiten eines Mikrofonarrays in Windows finden Sie in der Mikrofonarrayunterstützung in Windows Whitepaper.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ksmedia.h (enthalten Ksmedia.h) |