IXAudio2VoiceCallback 인터페이스(xaudio2.h)

아티클
03/13/2024

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가 음성의 버퍼 큐에서 데이터를 읽기 직전에 각 음성에 대한 각 처리 단계에서 호출됩니다.