IXAudio2SourceVoice::Stop 메서드(xaudio2.h)

아티클
08/28/2023

현재 음성으로 오디오 사용을 중지합니다.

구문

HRESULT Stop(
  [in] UINT32 Flags,
  [in] UINT32 OperationSet
);

매개 변수

[in] Flags

음성이 중지되는 방식을 제어하는 플래그입니다. 0 또는 다음일 수 있습니다.

값	Description
XAUDIO2_PLAY_TAILS	음성이 중지된 후에도 효과 출력을 계속 내보냅니다.

[in] OperationSet

이 호출을 지연된 일괄 처리의 일부로 식별합니다. 자세한 내용은 XAudio2 작업 집합 개요를 참조하세요.

반환 값

성공하면 S_OK 반환하고, 그렇지 않으면 오류 코드를 반환합니다. XAudio2 관련 오류 코드에 대한 설명은 XAudio2 오류 코드를 참조하세요.

설명

음성 및 현재 커서 위치에 큐에 대기 중인 모든 원본 버퍼는 유지됩니다. 이렇게 하면 음성이 다시 시작될 때 중단된 위치에서 음성을 계속할 수 있습니다. IXAudio2SourceVoice::FlushSourceBuffers 메서드를 사용하여 대기 중인 원본 버퍼를 플러시할 수 있습니다.

기본적으로 반향 꼬리와 같은 음성 효과의 보류 중인 출력은 재생되지 않습니다. 대신 음성이 즉시 자동으로 렌더링됩니다. XAUDIO2_PLAY_TAILS 플래그를 사용하여 음성 실행이 중지된 후에도 효과 출력을 계속 내보낼 수 있습니다.

XAUDIO2_PLAY_TAILS 플래그로 음성이 중지되면 원본 버퍼 사용이 중지되지만 계속 효과를 처리하고 대상 음성으로 오디오를 보냅니다. 나중에 Flags 인수가 0으로 설정된 상태에서 Stop 을 다시 호출하여 이 상태의 음성을 완전히 중지할 수 있습니다. 이렇게 하면 XAUDIO2_PLAY_TAILS 음성을 중지하고, 효과로 인해 생성되는 오디오가 완료될 때까지 충분한 시간을 기다린 다음, XAUDIO2_PLAY_TAILS 없이 다시 중지 를 호출하여 음성을 완전히 중지할 수 있습니다. 이 기술을 사용하면 효과가 있는 음성을 정상적으로 중지하는 동시에 유휴 음성이 오디오 생성을 완료한 후에도 계속 처리되지 않도록 할 수 있습니다.

콜 백 내에서 호출되는 경우에도 중지는 항상 비동기적입니다.

참고 XAudio2는 음성이 중지된 경우(XAUDIO2_PLAY_TAILS 중지된 경우에도) 음성에 대한 음성 콜백을 호출하지 않습니다.

플랫폼 요구 사항

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

요구 사항


대상 플랫폼	Windows
헤더	xaudio2.h

참고 항목

IXAudio2SourceVoice

XAPO 개요