IAudioClient::Stop 메서드(audioclient.h)

Stop 메서드는 오디오 스트림을 중지합니다.

구문

HRESULT Stop();

반환 값

메서드가 성공하고 스트림을 중지하면 S_OK 반환합니다. 메서드가 성공하고 스트림이 이미 중지된 경우 메서드는 S_FALSE 반환합니다. 실패할 경우 가능한 반환 코드에는 다음 표에 표시된 값이 포함되지만 이에 국한되지는 않습니다.

반환 코드	설명
AUDCLNT_E_NOT_INITIALIZED	클라이언트가 성공적으로 초기화되지 않았습니다.
AUDCLNT_E_SERVICE_NOT_RUNNING	Windows 오디오 서비스가 실행되고 있지 않습니다.

설명

이 메서드를 사용하려면 IAudioClient 인터페이스를 미리 초기화해야 합니다. 이 메서드에 대한 모든 호출은 클라이언트가 IAudioClient::Initialize 메서드를 성공적으로 호출하여 오디오 스트림을 초기화할 때까지 오류 AUDCLNT_E_NOT_INITIALIZED 실패합니다.

Stop 은 실행 중인 오디오 스트림을 중지하는 컨트롤 메서드입니다. 이 메서드는 오디오 엔진과 클라이언트의 연결을 통해 데이터를 스트리밍하는 것을 중지합니다. 스트림을 중지하면 스트림의 오디오 시계가 현재 스트림 위치에서 중지됩니다. IAudioClient::Start에 대한 후속 호출로 인해 스트림이 해당 위치에서 실행을 다시 시작합니다. 필요한 경우 클라이언트는 IAudioClient::Reset 메서드를 호출하여 스트림이 중지되는 동안 위치를 다시 설정할 수 있습니다.

Stop 메서드를 호출하는 코드 예제는 다음 topics 참조하세요.

• Stream 렌더링
• Stream 캡처

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	audioclient.h

추가 정보

IAudioClient 인터페이스

IAudioClient::Initialize

IAudioClient::Reset

IAudioClient::Start