X3DAudioCalculate 함수(x3daudio.h)

3D 매개 변수와 관련하여 DSP 설정을 계산합니다.

구문

X3DAUDIO_API_(void) X3DAudioCalculate(
  [in]      const X3DAUDIO_HANDLE   Instance,
  [in]      const X3DAUDIO_LISTENER *pListener,
  [in]      const X3DAUDIO_EMITTER  *pEmitter,
  [in]      UINT32                  Flags,
  [in, out] X3DAUDIO_DSP_SETTINGS   *pDSPSettings
);

매개 변수

[in] Instance

3D 오디오 instance 핸들. X3DAudioInitialize를 호출하여 이 핸들을 가져옵니다.

[in] pListener

수신 지점을 나타내는 X3DAUDIO_LISTENER 대한 포인터입니다.

[in] pEmitter

사운드 소스를 나타내는 X3DAUDIO_EMITTER 대한 포인터입니다.

[in] Flags

값	Description
X3DAUDIO_CALCULATE_MATRIX	행렬 계수 테이블 계산을 사용하도록 설정합니다.
X3DAUDIO_CALCULATE_DELAY	지연 시간 배열 계산을 사용하도록 설정합니다(스테레오만 해당).
X3DAUDIO_CALCULATE_LPF_DIRECT	LPF(로우 패스 필터) 직접 경로 계수 계산을 사용하도록 설정합니다.
X3DAUDIO_CALCULATE_LPF_REVERB	LPF 반향 경로 계수 계산을 사용하도록 설정합니다.
X3DAUDIO_CALCULATE_REVERB	반향 보내기 수준 계산을 사용하도록 설정합니다.
X3DAUDIO_CALCULATE_DOPPLER	Doppler 시프트 팩터 계산을 사용하도록 설정합니다.
X3DAUDIO_CALCULATE_EMITTER_ANGLE	발광자-수신기 내부 각도 계산을 사용하도록 설정합니다.
X3DAUDIO_CALCULATE_ZEROCENTER	가운데 채널을 무음으로 채웁니다. 이 플래그를 사용하면 채널을 다시 매핑할 필요가 없도록 6개 채널 행렬을 유지할 수 있지만 가운데 채널은 자동으로 유지됩니다. 이 플래그는 X3DAUDIO_CALCULATE_MATRIX 설정하는 경우에만 유효합니다.
X3DAUDIO_CALCULATE_REDIRECT_TO_LFE	모든 원본 채널의 동일한 혼합을 LFE(저주파 효과) 대상 채널에 적용합니다. LFE 채널이 없는 원본과 LFE 채널이 있는 대상의 행렬 계산에만 적용됩니다. 이 플래그는 X3DAUDIO_CALCULATE_MATRIX 설정하는 경우에만 유효합니다.

[in, out] pDSPSettings

계산 결과를 수신하는 X3DAUDIO_DSP_SETTINGS 구조체에 대한 포인터입니다.

반환 값

이 함수는 값을 반환하지 않습니다.

설명

일반적으로 장면에서 개체와 수신기를 내보내는 각 쌍에 대해 X3DAudioCalculate 를 한 번 호출합니다. 각 호출 후 3D 효과를 적용하기 위해 앱은 pDSPSettings 의 계산 결과를 XAUDIO2 그래프에 수동으로 적용합니다. 자세한 내용은 방법: XAudio2와 X3DAudio 통합을 참조하세요.

중요 수신기 및 방출기 값은 유효해야 합니다. 부동 소수점 특수(NaN, QNaN, +INF, -INF)는 실행 중인 오디오 그래프에 도입될 경우 전체 오디오 출력이 자동으로 진행되도록 할 수 있습니다.

 

플랫폼 요구 사항

Windows 10(XAudio2.9); Windows 8, Windows Phone 8(XAudio 2.8); DirectX SDK(XAudio 2.7)

Windows Phone 8.1: 이 API가 지원됩니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	x3daudio.h
라이브러리	Xaudio2.lib

참조

함수