IAudioClient 인터페이스(audioclient.h)

IAudioClient 인터페이스를 사용하면 클라이언트가 오디오 애플리케이션과 오디오 엔진(공유 모드 스트림의 경우) 또는 오디오 엔드포인트 디바이스의 하드웨어 버퍼(단독 모드 스트림용) 간에 오디오 스트림을 만들고 초기화할 수 있습니다. 클라이언트는 다음 단계에 따라 오디오 엔드포인트 디바이스에 대한 IAudioClient 인터페이스에 대한 참조를 가져옵니다.

1. IMMDevice 인터페이스에 설명된 기술 중 하나를 사용하여 오디오 엔드포인트 디바이스에 대한 IMMDevice 인터페이스에 대한 참조를 가져옵니다.
2. 매개 변수 iid가 REFIID IID_IAudioClient 설정된 IMMDevice::Activate 메서드를 호출합니다.

이 인터페이스를 사용하는 애플리케이션 스레드는 COM에 대해 초기화되어야 합니다. COM 초기화에 대한 자세한 내용은 Windows SDK 설명서의 CoInitializeEx 함수 설명을 참조하세요.

IAudioClient 인터페이스를 사용하는 코드 예제는 다음 topics 참조하세요.

• Stream 렌더링
• Stream 캡처
• 단독 모드 스트림

상속

IAudioClient 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IAudioClient 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IAudioClient 인터페이스에는 이러한 메서드가 있습니다.

IAudioClient::GetBufferSize GetBufferSize 메서드는 엔드포인트 버퍼의 크기(최대 용량)를 검색합니다.
IAudioClient::GetCurrentPadding GetCurrentPadding 메서드는 엔드포인트 버퍼의 패딩 프레임 수를 검색합니다.
IAudioClient::GetDevicePeriod GetDevicePeriod 메서드는 엔드포인트 버퍼의 데이터에 대한 오디오 엔진의 연속 처리 패스를 구분하는 주기적 간격의 길이를 검색합니다.
IAudioClient::GetMixFormat GetMixFormat 메서드는 오디오 엔진이 공유 모드 스트림의 내부 처리에 사용하는 스트림 형식을 검색합니다.
IAudioClient::GetService GetService 메서드는 오디오 클라이언트 개체에서 추가 서비스에 액세스합니다.
IAudioClient::GetStreamLatency GetStreamLatency 메서드는 현재 스트림의 최대 대기 시간을 검색하고 스트림이 초기화된 후 언제든지 호출할 수 있습니다.
IAudioClient::Initialize 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::Activate

WASAPI