다음을 통해 공유


IXAudio2VoiceCallback 인터페이스(xaudio2.h)

IXAudio2VoiceCallback 인터페이스에는 지정된 IXAudio2SourceVoice에서 특정 이벤트가 발생할 때 클라이언트에 알리는 메서드가 포함되어 있습니다.

이 인터페이스는 XAudio2 클라이언트에서 구현해야 합니다. XAudio2는 IXAudio2::CreateSourceVoice 메서드에서 클라이언트에서 제공하는 인터페이스 포인터를 통해 이러한 메서드를 호출합니다. 이 인터페이스의 메서드는 HRESULT가 아닌 void를 반환합니다.

콜백 구현에 대한 제한 사항은 XAudio2 콜백 항목을 참조하세요.

메서드 Description
OnBufferEnd 음성이 버퍼 처리를 완료할 때 호출됩니다.
OnBufferStart 음성이 새 오디오 버퍼 처리를 시작하려고 할 때 호출됩니다.
OnLoopEnd 음성이 루프의 끝 위치에 도달하면 호출됩니다.
OnStreamEnd 음성이 연속 오디오 스트림 재생을 막 마쳤을 때 호출됩니다.
OnVoiceError 음성 처리 중에 심각한 오류가 발생할 때 호출됩니다.
OnVoiceProcessingPassEnd 음성에 대한 처리 패스가 종료된 직후에 호출됩니다.
OnVoiceProcessingPassStart XAudio2가 음성의 버퍼 큐에서 데이터를 읽기 직전에 각 음성에 대한 각 처리 단계에서 호출됩니다.

메서드

IXAudio2VoiceCallback 인터페이스에는 이러한 메서드가 있습니다.

 
IXAudio2VoiceCallback::OnBufferEnd

음성이 버퍼 처리를 완료할 때 호출됩니다.
IXAudio2VoiceCallback::OnBufferStart

음성이 새 오디오 버퍼 처리를 시작하려고 할 때 호출됩니다.
IXAudio2VoiceCallback::OnLoopEnd

음성이 루프의 끝 위치에 도달하면 호출됩니다.
IXAudio2VoiceCallback::OnStreamEnd

음성이 연속 오디오 스트림 재생을 막 마쳤을 때 호출됩니다.
IXAudio2VoiceCallback::OnVoiceError

음성 처리 중에 심각한 오류가 발생할 때 호출됩니다.
IXAudio2VoiceCallback::OnVoiceProcessingPassEnd

음성에 대한 처리 패스가 종료된 직후에 호출됩니다.
IXAudio2VoiceCallback::OnVoiceProcessingPassStart

XAudio2가 음성의 버퍼 큐에서 데이터를 읽기 직전에 각 음성에 대한 각 처리 단계에서 호출됩니다.

설명

플랫폼 요구 사항

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

요구 사항

요구 사항
대상 플랫폼 Windows
헤더 xaudio2.h

추가 정보

방법: 디스크에서 소리 스트리밍

방법: 원본 음성 콜백 사용

XAudio2 콜백

XAudio2 인터페이스