XAudio2 API

XAudio2 API 기술에 대한 개요입니다.

XAudio2 API를 개발하려면 다음 헤더가 필요합니다.

• hrtfapoapi.h
• x3daudio.h
• xapo.h
• xapobase.h
• xapofx.h
• xaudio2.h
• xaudio2fx.h

이 기술에 대한 프로그래밍 지침은 다음을 참조하세요.

• XAudio2 API

클래스

CXAPOBase IXAPO 인터페이스의 기본 구현입니다.
CXAPOParametersBase IXAPOParameters 인터페이스의 기본 구현입니다.

열거형

HrtfDirectivityType 여러 주식 지향성 패턴 중 하나를 나타냅니다.
HrtfDistanceDecayType 소리에 적용된 거리 기반 감쇠 유형을 나타냅니다.
HrtfEnvironment 여러 주식 환경 유형 중 하나를 나타냅니다.
XAPO_BUFFER_FLAGS 스트림 버퍼의 내용을 설명합니다.
XAUDIO2_FILTER_TYPE 필터 유형을 나타냅니다.

Functions

AddRef XAudio2 개체에 대한 참조를 추가합니다.
BeginProcess 현재 프로세스 매개 변수를 반환합니다.
CalcInputFrames 지정된 출력 프레임 수를 생성하는 데 필요한 입력 프레임 수를 반환합니다.
CalcOutputFrames 지정된 수의 입력 프레임에서 생성되는 출력 프레임 수를 반환합니다.
CommitChanges 지정된 식별자를 사용하여 태그가 지정된 작업 집합을 원자적으로 적용합니다.
CreateFX 요청된 XAPOFX 효과의 instance 만듭니다.
CreateHrtfApo HRTF(헤드 관련 전송 함수) 처리를 위한 IXAPO 인터페이스의 instance 만듭니다.
CreateMasteringVoice 마스터 음성을 만들고 구성합니다.
CreateSourceVoice 원본 음성을 만들고 구성합니다.
CreateSubmixVoice 서브믹스 음성을 만들고 구성합니다.
CXAPOBase CXAPOBase 클래스의 instance 만듭니다.
CXAPOParametersBase CXAPOParametersBase 클래스의 instance 만듭니다.
DestroyVoice 음성을 파괴합니다. 필요한 경우 음성을 중지하고 XAudio2 그래프에서 제거합니다.
DisableEffect 음성의 효과 체인에서 지정된 위치에서 효과를 사용하지 않도록 설정합니다.
불연속 XAudio2 음성에 현재 큐에 있는 마지막 버퍼 다음에 더 이상 버퍼가 제공되지 않음을 알 수 있습니다.
EnableEffect 음성의 효과 체인에서 지정된 위치에서 효과를 사용하도록 설정합니다.
EndProcess CXAPOParametersBase에 XAPO가 현재 프로세스 매개 변수에 대한 액세스를 완료했음을 알 수 있습니다.
ExitLoop 현재 루프 영역의 끝에 도달하면 음성 반복을 중지합니다.
FlushSourceBuffers 음성 큐에서 보류 중인 모든 오디오 버퍼를 제거합니다.
GetChannelMask 이 음성의 채널 마스크를 반환합니다.
GetChannelVolumes 채널당 음성의 볼륨 수준을 반환합니다.
GetEffectParameters 음성 효과 체인에서 지정된 효과의 현재 효과별 매개 변수를 반환합니다.
GetEffectState 음성의 효과 체인에서 지정된 위치에 있는 효과의 실행 상태를 반환합니다.
GetFilterParameters 음성의 필터 매개 변수를 가져옵니다.
GetFrequencyRatio 음성의 주파수 조정 비율을 반환합니다.
GetOutputFilterParameters 이 음성의 송신 중 하나에서 필터 매개 변수를 반환합니다.
GetOutputMatrix 음성에 대한 최종 출력의 각 채널 볼륨 수준을 가져옵니다. 이러한 채널은 지정된 대상 음성의 입력 채널에 매핑됩니다.
GetParameters 효과별 매개 변수에 대한 현재 값을 가져옵니다.
GetPerformanceData 사용 가능한 메모리 또는 CPU 사용량과 같은 현재 리소스 사용량 세부 정보를 반환합니다.
GetRegistrationProperties XAPO의 등록 속성을 반환합니다.
GetRegistrationPropertiesInternal XAPO가 만들어진 등록 속성을 포함하는 XAPO_REGISTRATION_PROPERTIES 구조체에 대한 포인터를 반환합니다.
GetState 음성의 현재 커서 위치 데이터를 반환합니다.
GetVoiceDetails 음성의 생성 플래그, 입력 채널 및 샘플 속도에 대한 정보를 반환합니다.
GetVolume 음성의 현재 전체 볼륨 수준을 가져옵니다.
초기화 효과별 초기화를 수행합니다.
IsInputFormatSupported 특정 입력 형식이 지정된 출력 형식에 대해 지원되는지 쿼리합니다.
IsLocked XAPO가 잠겨 있는지 여부를 쿼리합니다.
IsOutputFormatSupported 특정 출력 형식이 지정된 입력 형식에 대해 지원되는지 쿼리합니다.
LockForProcess XAudio2에서 호출되어 XAPO의 입력 및 출력 구성을 잠그면 실시간 스레드에서 Process가 호출되기 전에 최종 초기화를 수행할 수 있습니다.
OnBufferEnd 음성이 버퍼 처리를 완료할 때 호출됩니다.
OnBufferStart 음성이 새 오디오 버퍼 처리를 시작하려고 할 때 호출됩니다.
OnCriticalError XAudio2를 종료하고 다시 시작해야 하는 중요한 시스템 오류가 발생하는 경우 호출됩니다.
OnLoopEnd 음성이 루프의 끝 위치에 도달하면 호출됩니다.
OnProcessingPassEnd 오디오 처리 패스가 종료된 직후 XAudio2에서 호출됩니다.
OnProcessingPassStart 오디오 처리 단계가 시작되기 직전에 XAudio2에서 호출됩니다.
OnSetParameters 사용자 정의 매개 변수 유효성 검사를 허용하기 위해 IXAPOParameters::SetParameters에서 호출됩니다.
OnStreamEnd 음성이 연속 오디오 스트림 재생을 막 마쳤을 때 호출됩니다.
OnVoiceError 음성 처리 중에 심각한 오류가 발생할 때 호출됩니다.
OnVoiceProcessingPassEnd 음성에 대한 처리 패스가 종료된 직후에 호출됩니다.
OnVoiceProcessingPassStart XAudio2가 음성의 버퍼 큐에서 데이터를 읽기 직전에 각 음성에 대한 각 처리 단계에서 호출됩니다.
ParametersChanged 마지막 처리 단계 이후 IXAPOParameters::SetParameters가 호출되었는지를 나타냅니다.
처리 지정된 입력 및 출력 버퍼에서 XAPO의 DSP(디지털 신호 처리) 코드를 실행합니다.
ProcessThru XAPO를 통해 처리할 수 없으면 IXAPO::P rocess 구현에서 호출됩니다.
QueryInterface XAudio2 개체의 지정된 COM 인터페이스에 대한 쿼리입니다.
RegisterForCallbacks XAudio2 엔진 콜백 목록에 IXAudio2EngineCallback 포인터를 추가합니다.
릴리스 XAudio2 개체에 대한 참조를 해제합니다.
Reset 프레임 기록에 따라 변수를 다시 설정합니다.
ReverbConvertI3DL2ToNative I3DL2(대화형 3D 오디오 렌더링 지침 수준 2.0) 매개 변수를 네이티브 XAudio2 매개 변수로 변환하는 인라인 함수입니다.
SetChannelVolumes 채널당 음성의 볼륨 수준을 설정합니다.
SetDebugConfiguration XAudio2에 대한 전역 디버그 로깅 옵션을 변경합니다.
SetEffectChain 음성의 효과 체인을 바꿉니다.
SetEffectParameters 음성 효과 체인에서 지정된 효과에 대한 매개 변수를 설정합니다.
SetEnvironment 시뮬레이션할 음향 환경을 선택합니다.
SetFilterParameters 음성의 필터 매개 변수를 설정합니다.
SetFrequencyRatio 음성의 주파수 조정 비율을 설정합니다.
SetOutputFilterParameters 이 음성의 송신 중 하나에서 필터 매개 변수를 설정합니다.
SetOutputMatrix 음성에 대한 최종 출력의 각 채널 볼륨 수준을 설정합니다. 이러한 채널은 지정된 대상 음성의 입력 채널에 매핑됩니다.
SetOutputVoices 음성의 출력을 수신할 새 서브믹스 또는 마스터링 음성 집합을 지정합니다.
SetParameters 효과별 매개 변수를 설정합니다.
SetSourceGain 현재 원본 위치에 대한 사용자 지정 직접 경로 게인 값을 설정합니다. HrtfDistanceDecayType 사용자 지정 감쇠 유형으로 재생되는 소리에만 유효합니다.
SetSourceOrientation 수신기의 좌표계와 관련하여 원본 방향에 대한 회전 행렬을 설정합니다.
SetSourcePosition 수신기를 기준으로 소리의 위치를 설정합니다.
SetSourceSampleRate 음성을 만들 때 지정된 속도와 다른 샘플 속도로 원본 데이터를 사용하도록 음성을 다시 구성합니다.
SetVolume 음성의 전체 볼륨 수준을 설정합니다.
시작 음성으로 오디오의 사용 및 처리를 시작합니다. 연결된 서브믹스 또는 마스터링 음성 또는 출력 디바이스에 결과를 전달합니다.
Startengine 오디오 처리 스레드를 시작합니다.
중지 현재 음성으로 오디오 사용을 중지합니다.
StopEngine 오디오 처리 스레드를 중지합니다.
SubmitSourceBuffer 음성 큐에 새 오디오 버퍼를 추가합니다.
UnlockForProcess LockForProcess 메서드를 사용하여 할당된 변수의 할당을 취소합니다.
UnregisterForCallbacks XAudio2 엔진 콜백 목록에서 IXAudio2EngineCallback 포인터를 제거합니다.
ValidateFormatDefault 오디오 형식이 지원되는 기본 범위 내에 속하는지 확인합니다.
ValidateFormatPair XAPO에서 입력 및 출력 형식 쌍 구성을 지원하는지 확인합니다.
X3DAudioCalculate 3D 매개 변수에 대한 DSP 설정을 계산합니다.
X3DAudioInitialize 모든 전역 3D 오디오 상수를 설정합니다.
XAPOAlloc 이후에 애플리케이션에 반환되는 임의의 크기의 구조를 할당해야 하는 IXAPO 메서드에서 사용하는 메모리 할당 매크로입니다.
XAPOFree XAPOAlloc 매크로를 사용하여 할당된 메모리를 해제하는 데 사용되는 매크로입니다.
XAudio2AmplitudeRatioToDecibels 진폭 비율 값을 decibel 값으로 변환하는 인라인 함수입니다.
XAudio2만들기 새 XAudio2 개체를 만들고 IXAudio2 인터페이스에 대한 포인터를 반환합니다.
XAudio2CreateReverb 새 반향 오디오 처리 개체(APO)를 만들고 포인터를 반환합니다.
XAudio2CreateVolumeMeter 새 볼륨 미터 APO(오디오 처리 개체)를 만들고 포인터를 반환합니다.
XAudio2CutoffFrequencyToOnePoleCoefficient 헤르츠로 표현된 필터 컷오프 주파수에서 XAUDIO2_FILTER_PARAMETERS 구조체의 Frequency 멤버와 함께 사용되는 필터 계수로 변환하는 인라인 함수입니다.
XAudio2CutoffFrequencyToRadians 헤르츠로 표현된 필터 차단 주파수에서 XAUDIO2_FILTER_PARAMETERS 구조체의 Frequency 멤버에 사용되는 라디안 주파수 값으로 변환하는 인라인 함수입니다.
XAudio2DecibelsToAmplitudeRatio decibel 값을 진폭 비율 값으로 변환하는 인라인 함수입니다.
XAudio2FrequencyRatioToSemitones 빈도 비율 값을 세미톤 값으로 변환하는 인라인 함수입니다.
XAudio2RadiansToCutoffFrequency XAUDIO2_FILTER_PARAMETERS 사용되는 라디안 주파수에서 hertz의 절대 주파수로 다시 변환하는 인라인 함수입니다.
XAudio2SemitonesToFrequencyRatio 세미톤 값을 주파수 비율 값으로 변환하는 인라인 함수입니다.

인터페이스

IXAPO XAudio2 효과 체인에 사용되는 오디오 처리 개체의 인터페이스입니다.
IXAPOHrtfParameters HRTF(헤드 관련 전송 함수)가 소리에 적용되는 방식을 제어하는 매개 변수를 설정하는 데 사용되는 인터페이스입니다.
IXAPOParameters XAPO가 효과별 매개 변수를 사용할 수 있도록 하는 선택적 인터페이스입니다.
IXAudio2 IXAudio2는 모든 오디오 엔진 상태, 오디오 처리 스레드, 음성 그래프 등을 관리하는 XAudio2 개체의 인터페이스입니다.
IXAudio2EngineCallback IXAudio2EngineCallback 인터페이스에는 IXAudio2 엔진에서 특정 이벤트가 발생할 때 클라이언트에 알리는 메서드가 포함되어 있습니다.
IXAudio2MasteringVoice 마스터 음성은 오디오 출력 디바이스를 나타내는 데 사용됩니다.
IXAudio2SourceVoice 원본 음성을 사용하여 오디오 데이터를 XAudio2 처리 파이프라인에 제출합니다.
IXAudio2SubmixVoice 서브믹스 음성은 주로 성능 향상 및 효과 처리에 사용됩니다.
IXAudio2Voice IXAudio2Voice는 IXAudio2SourceVoice, IXAudio2SubmixVoice 및 IXAudio2MasteringVoice가 파생되는 기본 인터페이스를 나타냅니다. 아래에 나열된 메서드는 모든 음성 서브클래스에 공통적으로 적용됩니다.
IXAudio2VoiceCallback IXAudio2VoiceCallback 인터페이스에는 지정된 IXAudio2SourceVoice에서 특정 이벤트가 발생할 때 클라이언트에 알리는 메서드가 포함되어 있습니다.

구조체

FXECHO_INITDATA FXECHO XAPOFX와 함께 사용할 초기화 매개 변수입니다.
FXECHO_PARAMETERS FXECHO XAPOFX와 함께 사용할 매개 변수입니다.
FXEQ_PARAMETERS FXEQ XAPO와 함께 사용할 매개 변수입니다.
FXMASTERINGLIMITER_PARAMETERS FXMasteringLimiter XAPO와 함께 사용할 매개 변수입니다.
FXREVERB_PARAMETERS FXReverb XAPO와 함께 사용할 매개 변수입니다.
HrtfApoInit HRTF 공간 오디오를 초기화하는 데 사용되는 매개 변수를 지정합니다.
HrtfDirectivity 기본 직접성 패턴 설명자입니다. 소리에 적용되는 직접성의 유형을 설명합니다.
HrtfDirectivityCardioid 심장 지향성 패턴을 설명합니다.
HrtfDirectivityCone 원뿔 방향성을 설명합니다.
HrtfDistanceDecay 거리 기반 감쇠 동작을 설명합니다.
HrtfOrientation HRTF 직접성 개체의 방향을 나타냅니다.
HrtfPosition 오른손 좌표계를 사용하여 3D 공간의 위치를 나타냅니다.
X3DAUDIO_CONE 방출기 방향과 관련하여 DSP 동작의 크기를 조정하여 단일 채널 비 LFE 방출기 방향성을 지정합니다.
X3DAUDIO_DISTANCE_CURVE 선형 세그먼트로 구성된 명시적 조각 곡선을 정의하여 정규화된 거리와 관련하여 DSP 동작을 직접 정의합니다.
X3DAUDIO_DISTANCE_CURVE_POINT 지정된 정규화된 거리에서 DSP 설정을 정의합니다.
X3DAUDIO_DSP_SETTINGS X3DAudioCalculate 호출에서 결과를 받습니다.
X3DAUDIO_EMITTER 임의의 수의 사운드 채널과 함께 사용되는 단일 지점 또는 다중 지점 3D 오디오 원본을 정의합니다.
X3DAUDIO_LISTENER 3D 오디오 수신 지점을 정의합니다.
XAPO_LOCKFORPROCESS_PARAMETERS XAPO가 잠겨 있는 동안 일정하게 유지되는 스트림 버퍼 매개 변수를 정의합니다. IXAPO::LockForProcess 메서드와 함께 사용됩니다.
XAPO_PROCESS_BUFFER_PARAMETERS 한 호출에서 다음 호출로 변경할 수 있는 스트림 버퍼 매개 변수를 정의합니다. Process 메서드와 함께 사용됩니다.
XAPO_REGISTRATION_PROPERTIES XAPO의 일반적인 특징을 설명합니다. IXAPO::GetRegistrationProperties, CXAPOParametersBase::CXAPOParametersBase 및 CXAPOBase::CXAPOBase와 함께 사용됩니다.
XAUDIO2_BUFFER IXAudio2SourceVoice::SubmitSourceBuffer와 함께 사용되는 오디오 데이터 버퍼를 나타냅니다.
XAUDIO2_BUFFER_WMA xWMA 데이터를 제출할 때 IXAudio2SourceVoice::SubmitSourceBuffer와 함께 사용됩니다.
XAUDIO2_DEBUG_CONFIGURATION XAudio2에 대한 새 전역 디버그 구성을 포함합니다. SetDebugConfiguration 함수와 함께 사용됩니다.
XAUDIO2_EFFECT_CHAIN 효과 체인을 정의합니다.
XAUDIO2_EFFECT_DESCRIPTOR 효과 체인에 사용할 XAPO에 대한 정보를 포함합니다.
XAUDIO2_FILTER_PARAMETERS 원본 음성에 대한 필터 매개 변수를 정의합니다.
XAUDIO2_PERFORMANCE_DATA 성능 정보를 포함합니다. (XAUDIO2_PERFORMANCE_DATA)
XAUDIO2_SEND_DESCRIPTOR 다른 음성에서 보내는 대상인 대상 음성을 정의하고 필터를 사용해야 하는지 여부를 지정합니다.
XAUDIO2_VOICE_DETAILS 음성의 생성 플래그, 입력 채널 및 샘플 속도에 대한 정보를 포함합니다.
XAUDIO2_VOICE_SENDS 단일 출력 음성에서 데이터를 수신하는 음성 집합을 정의합니다.
XAUDIO2_VOICE_STATE 음성의 현재 상태 및 커서 위치 데이터를 반환합니다.
XAUDIO2FX_REVERB_I3DL2_PARAMETERS ReverbConvertI3DL2ToNative 함수에서 사용할 I3DL2(대화형 3D 오디오 렌더링 지침 수준 2.0) 매개 변수에 대해 설명합니다.
XAUDIO2FX_REVERB_PARAMETERS 반향 APO에서 사용할 매개 변수를 설명합니다.
XAUDIO2FX_VOLUMEMETER_LEVELS 볼륨 미터 APO와 함께 사용할 매개 변수에 대해 설명합니다.