KSAUDIO_MIC_ARRAY_GEOMETRY 구조체(ksmedia.h)
KSAUDIO_MIC_ARRAY_GEOMETRY 구조체는 마이크 배열의 형식과 기하 도형을 지정합니다. usNumberOfMicrophones 멤버는 실제 배열의 마이크 수를 나타냅니다. KsMicCoord 멤버는 KSAUDIO_MICROPHONE_COORDINATES 형식의 변수이며 구조체의 배열입니다. 이 배열의 항목 수는 usNumberOfMicrophones 멤버의 값으로 제공됩니다.
구문
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;
멤버
usVersion
KSAUDIO_MIC_ARRAY_GEOMETRY 구조체의 버전 번호를 지정합니다. 이 멤버는 BCD 값이며 현재 버전 번호 1.0을 나타내는 0x0100 설정됩니다.
usMicArrayType
사용 중인 마이크 배열의 유형을 지정합니다. 이 멤버는 다음 표에 표시된 KSMICARRAY_MICARRAYTYPE 열거형 값 중 하나일 수 있습니다.
| 값 | 마이크 배열 유형 |
|---|---|
| KSMICARRAY_MICARRAYTYPE_LINEAR | 선형 |
| KSMICARRAY_MICARRAYTYPE_PLANAR | 평면 |
| KSMICARRAY_MICARRAYTYPE_3D | 3D |
wVerticalAngleBegin
마이크 배열의 작업 볼륨 시작 부분의 세로 각도를 지정합니다.
wVerticalAngleEnd
마이크 배열의 작업 볼륨 끝의 세로 각도를 지정합니다.
wHorizontalAngleBegin
작업 볼륨 HorizontalAngle Begin
wHorizontalAngleEnd
작업 볼륨 HorizontalAngle 끝
usFrequencyBandLo
마이크 배열에 대한 주파수 범위의 하위 끝을 지정합니다.
usFrequencyBandHi
마이크 배열에 대한 주파수 범위의 하이 엔드를 지정합니다.
usNumberOfMicrophones
마이크 배열의 마이크 수를 지정합니다.
KsMicCoord[1]
배열에 있는 마이크의 위치를 포함하는 KSAUDIO_MICROPHONE_COORDINATES 구조체의 배열을 지정합니다.
설명
모든 각도 값은 라디안의 1/10000번째 단위로 표현됩니다. 예를 들어 3.1416 라디안은 31416 단위로 표현됩니다. 허용되는 값 범위는 -31416에서 31416 단위까지입니다.
모든 좌표 값은 밀리미터 단위로 표현됩니다. 허용되는 값은 -32768에서 32767까지입니다( 포함).
빈도 값은 Hertz(Hz)로 표현됩니다.
Windows에서 마이크 배열을 처리하는 방법에 대한 자세한 내용은 Windows 백서의 마이크 배열 지원을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | ksmedia.h(Ksmedia.h 포함) |