IXAudio2VoiceCallback::OnBufferStart 메서드(xaudio2.h)

아티클
03/13/2024

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

구문

void OnBufferStart(
  void *pBufferContext
);

매개 변수

pBufferContext

버퍼가 제출될 때 XAUDIO2_BUFFER 구조체의 pContext 멤버에 할당된 컨텍스트 포인터입니다.

반환 값

없음

설명

pBufferContext는 원래 XAUDIO2_BUFFER 구조체의 pContext 멤버가 제공한 컨텍스트 포인터로, NULL일 수 있습니다.

OnBufferStart 는 현재 버퍼의 첫 번째 바이트가 사용되기 직전에 호출되도록 보장됩니다. 다음과 같은 음성 상태 변경에 이 콜백을 사용하는 것이 적절합니다.

음성에 새 버퍼 제출
음성의 볼륨, 피치 및 효과 매개 변수 조정
음성 효과 체인에서 효과 사용 또는 사용 안 함

위에 나열된 모든 작업은 XAudio2 콜백에서 수행될 때 동기적이므로 변경 내용이 즉시 적용되어 시작하려는 버퍼에 영향을 줍니다.

또한 대기 시간이 짧은 스트리밍 시나리오에 유용할 수 있는 이 콜백을 사용하여 오디오 데이터를 버퍼에 직접 쓰는 것도 안전합니다. 그러나 모든 XAudio2 콜백과 마찬가지로 상당한 양의 프로세서 시간을 사용하거나 동기 디스크 또는 네트워크 읽기를 포함하여 실행을 차단할 수 있는 작업은 수행해서는 안 됩니다.

IXAudio2VoiceCallback 인터페이스 메서드에 대한 자세한 내용은 XAudio2 콜백 섹션을 참조하세요.