audioclient.h 헤더

이 헤더는 핵심 오디오 API에서 사용됩니다. 자세한 내용은 다음을 참조하세요.

• 핵심 오디오 API

audioclient.h에는 다음과 같은 프로그래밍 인터페이스가 포함되어 있습니다.

인터페이스

IAcousticEchoCancellationControl 오디오 캡처 엔드포인트가 AEC(음향 에코 취소)를 지원하는지 여부를 결정하는 메커니즘을 제공하며, 이 경우 클라이언트가 참조 스트림으로 사용해야 하는 오디오 렌더링 엔드포인트를 설정할 수 있도록 합니다.
IAudioCaptureClient IAudioCaptureClient 인터페이스를 사용하면 클라이언트가 캡처 엔드포인트 버퍼에서 입력 데이터를 읽을 수 있습니다.
IAudioClient IAudioClient 인터페이스를 사용하면 클라이언트가 오디오 애플리케이션과 오디오 엔진(공유 모드 스트림의 경우) 또는 오디오 엔드포인트 디바이스의 하드웨어 버퍼(단독 모드 스트림용) 간에 오디오 스트림을 만들고 초기화할 수 있습니다.
IAudioClient2 IAudioClient2 인터페이스는 IAudioClient 인터페이스에서 파생되며, WASAPI(Windows Audio Session API) 오디오 클라이언트가 다음을 수행할 수 있도록 하는 추가 메서드 집합이 있습니다._opt 오프로드, 쿼리 스트림 속성 및 오프로드를 처리하는 하드웨어에서 정보를 가져옵니다. 기본 엔드포인트가 하드웨어 오디오 엔진을 지원하고, 엔드포인트가 오디오 시스템에서 열거되고 검색되었으며, 엔드포인트에서 사용할 수 있는 오프로드 핀 인스턴스가 여전히 있는 경우 오디오 클라이언트가 오프로드된 스트림을 만드는 데 성공할 수 있습니다.
IAudioClient3 IAudioClient3 인터페이스는 IAudioClient2 인터페이스에서 파생되며, WASAPI(Windows Audio Session API) 오디오 클라이언트가 오디오 엔진의 지원되는 주기 및 현재 주기를 쿼리하고 지정된 주기로 공유 오디오 스트림의 초기화를 요청할 수 있는 추가 메서드 집합이 있습니다.
IAudioClientDuckingControl 앱의 오디오 렌더링 스트림이 활성 상태일 때 시스템에서 다른 스트림의 오디오를 더킹하지 않도록 앱이 지정할 수 있는 SetDuckingOptionsForCurrentStream 메서드를 제공합니다.
IAudioClock IAudioClock 인터페이스를 사용하면 클라이언트가 스트림의 데이터 속도와 스트림의 현재 위치를 모니터링할 수 있습니다.
IAudioClock2 IAudioClock2 인터페이스는 현재 디바이스 위치를 가져오는 데 사용됩니다.
IAudioClockAdjustment IAudioClockAdjustment 인터페이스는 스트림의 샘플 속도를 조정하는 데 사용됩니다.
IAudioEffectsChangedNotificationClient 콜백 인터페이스를 사용하면 오디오 효과 목록이 변경되거나 효과 변경을 사용하도록 설정하는 데 필요한 리소스가 변경될 때 애플리케이션에서 알림을 받을 수 있습니다.
IAudioEffectsManager 오디오 효과 파이프라인에 대한 관리 기능을 제공합니다.
IAudioRenderClient IAudioRenderClient 인터페이스를 사용하면 클라이언트가 렌더링 엔드포인트 버퍼에 출력 데이터를 쓸 수 있습니다.
IAudioStreamVolume IAudioStreamVolume 인터페이스를 사용하면 클라이언트가 오디오 스트림의 모든 채널에 대한 볼륨 수준을 제어하고 모니터링할 수 있습니다.
IAudioViewManagerService HWND를 오디오 스트림과 연결하기 위한 API를 제공합니다.
IChannelAudioVolume IChannelAudioVolume 인터페이스를 사용하면 클라이언트가 스트림이 속한 오디오 세션의 모든 채널에 대한 볼륨 수준을 제어하고 모니터링할 수 있습니다.
ISimpleAudioVolume ISimpleAudioVolume 인터페이스를 사용하면 클라이언트가 오디오 세션의 마스터 볼륨 수준을 제어할 수 있습니다.

구조체

AUDIO_EFFECT 오디오 효과를 나타냅니다.
AudioClientProperties AudioClientProperties 구조체(audioclient.h)는 클라이언트 오디오 스트림의 속성을 설명하는 매개 변수를 설정하는 데 사용됩니다.

열거형

_AUDCLNT_BUFFERFLAGS _AUDCLNT_BUFFERFLAGS 열거형은 오디오 엔드포인트 버퍼의 상태를 나타내는 플래그를 정의합니다.
AUDCLNT_STREAMOPTIONS 오디오 스트림의 특성을 설명하는 값을 정의합니다.
AUDIO_DUCKING_OPTIONS 오디오 더킹 옵션을 지정합니다. IAudioClientDuckingControl::SetDuckingOptionsForCurrentStream을 호출할 때 이 열거형의 값을 사용합니다.
AUDIO_EFFECT_STATE 오디오 효과의 상태를 지정합니다.