IAudioClient 인터페이스(audioclient.h)
IAudioClient 인터페이스를 사용하면 클라이언트가 오디오 애플리케이션과 오디오 엔진(공유 모드 스트림의 경우) 또는 오디오 엔드포인트 디바이스 하드웨어 버퍼 간에 오디오 스트림을 만들고 초기화할 수 있습니다(전용 모드 스트림의 경우). 클라이언트는 다음 단계에 따라 오디오 엔드포인트 디바이스에 대한 IAudioClient 인터페이스에 대한 참조를 가져옵니다.
- IMMDevice 인터페이스설명된 기술 중 하나를 사용하여 오디오 엔드포인트 디바이스에 대한 IMMDevice 인터페이스에 대한 참조를 가져옵니다.
- 매개 변수 iid REFIID IID_IAudioClient 설정된 IMMDevice::Activate 메서드를 호출합니다. Windows 10 빌드 20348부터 호출자는 프로세스 필터를 사용하여 루프백 캡처에 대한 IAudioClient 구성하는 AUDIOCLIENT_ACTIVATION_PARAMS 전달할 수 있습니다.
이 인터페이스를 사용하는 애플리케이션 스레드는 COM용으로 초기화되어야 합니다. COM 초기화에 대한 자세한 내용은 Windows SDK 설명서의 CoInitializeEx 함수에 대한 설명을 참조하세요.
IAudioClient 인터페이스를 사용하는 코드 예제는 다음 항목을 참조하세요.
-
스트림 렌더링
-
스트림 캡처하는
- Exclusive-Mode 스트림
상속
IAudioClient 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IAudioClient 다음과 같은 형식의 멤버도 있습니다.
방법
IAudioClient 인터페이스에는 이러한 메서드가 있습니다.
|
IAudioClient::GetBufferSize GetBufferSize 메서드는 엔드포인트 버퍼의 크기(최대 용량)를 검색합니다. |
|
IAudioClient::GetCurrentPadding GetCurrentPadding 메서드는 엔드포인트 버퍼의 패딩 프레임 수를 검색합니다. |
|
IAudioClient::GetDevicePeriod GetDevicePeriod 메서드는 엔드포인트 버퍼의 데이터에 대한 오디오 엔진의 연속 처리 패스를 구분하는 주기적 간격의 길이를 검색합니다. |
|
IAudioClient::GetMixFormat GetMixFormat 메서드는 오디오 엔진이 공유 모드 스트림의 내부 처리에 사용하는 스트림 형식을 검색합니다. |
|
IAudioClient::GetService GetService 메서드는 오디오 클라이언트 개체에서 추가 서비스에 액세스합니다. |
|
IAudioClient::GetStreamLatency GetStreamLatency 메서드는 현재 스트림의 최대 대기 시간을 검색하고 스트림이 초기화된 후 언제든지 호출할 수 있습니다. |
|
IAudioClient:: 초기화 Initialize 메서드는 오디오 스트림을 초기화합니다. |
|
IAudioClient::IsFormatSupported IsFormatSupported 메서드는 오디오 엔드포인트 디바이스가 특정 스트림 형식을 지원하는지 여부를 나타냅니다. |
|
IAudioClient::reset Reset 메서드는 오디오 스트림을 다시 설정합니다. |
|
IAudioClient::SetEventHandle SetEventHandle 메서드는 클라이언트에서 오디오 버퍼를 처리할 준비가 되면 시스템에서 신호를 받는 이벤트 핸들을 설정합니다. |
|
IAudioClient::Start Start 메서드는 오디오 스트림을 시작합니다. |
|
IAudioClient::stop Stop 메서드는 오디오 스트림을 중지합니다. |
발언
참고 Windows 8에서는 오디오 디바이스에 액세스하는 IAudioClient 처음 사용하는 것이 STA 스레드에 있어야 합니다. MTA 스레드에서 호출하면 정의되지 않은 동작이 발생할 수 있습니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | audioclient.h |
참고 항목
핵심 오디오 인터페이스
IMMDevice:: 활성화
WASAPI