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 포함)

추가 정보

KSAUDIO_MICROPHONE_COORDINATES