IXAudio2SourceVoice::Stop 메서드(xaudio2.h)
현재 음성으로 오디오 사용을 중지합니다.
구문
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 없이 다시 중지 를 호출하여 음성을 완전히 중지할 수 있습니다. 이 기술을 사용하면 효과가 있는 음성을 정상적으로 중지하는 동시에 유휴 음성이 오디오 생성을 완료한 후에도 계속 처리되지 않도록 할 수 있습니다.
콜 백 내에서 호출되는 경우에도 중지는 항상 비동기적입니다.
플랫폼 요구 사항
Windows 10(XAudio2.9); Windows 8, Windows Phone 8(XAudio 2.8); DirectX SDK(XAudio 2.7)요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | xaudio2.h |