KSAUDIO_MICROPHONE_COORDINATES 구조체(ksmedia.h)

KSAUDIO_MICROPHONE_COORDINATES 구조는 마이크 배열에 있는 단일 마이크의 유형과 좌표를 지정합니다.

구문

typedef struct {
  USHORT usType;
  SHORT  wXCoord;
  SHORT  wYCoord;
  SHORT  wZCoord;
  SHORT  wVerticalAngle;
  SHORT  wHorizontalAngle;
} KSAUDIO_MICROPHONE_COORDINATES, *PKSAUDIO_MICROPHONE_COORDINATES;

구성원

usType

이 좌표 위치에서 사용 중인 마이크 유형을 지정합니다. 이 멤버의 값은 다음 표에 표시된 KSMICARRAY_MICTYPE 열거형 값 중 하나입니다.

값	마이크 유형
KSMICARRAY_MICTYPE_OMNIDIRECTIONAL	옴니 방향
KSMICARRAY_MICTYPE_SUBCARDIOID	하위 카르디오이드
KSMICARRAY_MICTYPE_CARDIOID	Cardioid
KSMICARRAY_MICTYPE_SUPERCARDIOID	슈퍼 카디오이드
KSMICARRAY_MICTYPE_HYPERCARDIOID	하이퍼 카디오이드
KSMICARRAY_MICTYPE_8SHAPED	8자형
KSMICARRAY_MICTYPE_VENDORDEFINED	0x0F

마이크가 KSMICARRAY_MICTYPE_VENDORDEFINED 형식인 경우 값을 0x0F 설정해야 합니다. 또한 가장 중요한 비트는 마이크 유형을 추가로 정의합니다.

wXCoord

마이크의 서명된 X 좌표를 밀리미터 단위로 지정합니다. 허용되는 값의 범위는 -32768에서 32767까지입니다.

wYCoord

마이크의 부 서명된 Y 좌표를 밀리미터 단위로 지정합니다. 허용되는 값의 범위는 -32768에서 32767까지입니다.

wZCoord

마이크의 부호 있는 Z 좌표를 밀리미터 단위로 지정합니다. 허용되는 값의 범위는 -32768에서 32767까지입니다.

wVerticalAngle

-15708에서 +15708 사이의 값을 지정합니다. 10,000으로 나눈 경우 라디안 각도 측정을 제공합니다.

wHorizontalAngle

-31416에서 +31416 사이의 값을 지정합니다. 10,000으로 나눈 경우 라디안 각도 측정을 제공합니다.

설명

wHorizontalAngle 및 wVerticalAngle 에 대한 설명을 더 잘 이해하려면 다음 다이어그램을 고려하세요.

x 는 마이크 배열의 중심에서 사용자의 가장 가능성이 있는 위치( 즉, 화면에 수직)를 가리키는 축이 되게 합니다. 긍정은 사용자에 대한 것입니다. 음수는 화면 뒤에 있습니다. x축에 수직으로 가로 축으로 y 를 하자 - 즉, 화면의 왼쪽에서 오른쪽으로. 긍정은 사용자의 오른쪽에 있습니다. 음수는 사용자의 왼쪽에 있습니다. z 를 세로 축으로 지정합니다.

이제 이전 다이어그램과 같이 배열에 세 개의 마이크가 있다고 가정합니다. 또한 마이크(Mic 1) 중 하나가 마이크 1 을 통해 파란색 가운데 선으로 표시된 것처럼 x축과 평행하지 않은 가로 방향으로 가리킨다고 가정합니다. 이제 (x,y,z) 좌표계의 원점(0,0,0)을 통해 실행되고 마이크 1 의 중심선과 평행한 선이 있다고 상상하면 양의 x축과 마이크 중심선이 x-y 평면에 투영되는 사이에 가로 각도가 있음을 알 수 있습니다. 이 각도는 wHorizontalAngle 로 표시됩니다.

마이크 중 하나(예: 마이크 1)가 아래로 담그거나 위로 올라간 경우 이 마이크는 중심선과 중심선의 투영 사이의 수직 각도를 x-y 평면에 배치합니다. 이 각도는 wVerticalAngle 로 표시됩니다.

Windows 마이크 배열을 처리하는 방법에 대한 자세한 내용은 Windows 백서의 마이크 배열 지원을 참조하세요.

요구 사항

헤더	ksmedia.h(Ksmedia.h 포함)