IAudioCaptureClient 인터페이스(audioclient.h)

IAudioCaptureClient 인터페이스를 사용하면 클라이언트가 캡처 엔드포인트 버퍼에서 입력 데이터를 읽을 수 있습니다. 클라이언트는 REFIID IID_IAudioCaptureClient 설정된 매개 변수 riid를 사용하여 IAudioClient::GetService 메서드를 호출하여 스트림 개체에서 IAudioCaptureClient 인터페이스에 대한 참조를 가져옵니다.

이 인터페이스의 메서드는 캡처 데이터를 포함하는 데이터 패킷의 이동을 관리합니다. 데이터 패킷의 길이는 패킷의 오디오 프레임 수로 표현됩니다. 오디오 프레임의 크기는 IAudioClient::GetMixFormat 메서드를 호출하여 클라이언트가 가져오는 WAVEFORMATEX(또는 WAVEFORMATEXTENSIBLE) 구조체의 nBlockAlign 멤버에 의해 지정됩니다. 오디오 프레임의 크기(바이트)는 스트림의 채널 수와 채널당 샘플 크기를 곱한 값입니다. 예를 들어 프레임 크기는 16비트 샘플이 있는 스테레오(2 채널) 스트림의 경우 4바이트입니다. 패킷에는 항상 정수의 오디오 프레임이 포함됩니다.

instance IAudioCaptureClient 인터페이스를 해제할 때 클라이언트는 개체를 만든 IAudioClient::GetService 호출과 동일한 스레드에서 instance Release 메서드를 호출해야 합니다.

IAudioCaptureClient 인터페이스를 사용하는 코드 예제는 Stream 캡처를 참조하세요.

상속

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

메서드

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

IAudioCaptureClient::GetBuffer 캡처 엔드포인트 버퍼에서 사용 가능한 다음 데이터 패킷에 대한 포인터를 검색합니다.
IAudioCaptureClient::GetNextPacketSize GetNextPacketSize 메서드는 캡처 엔드포인트 버퍼의 다음 데이터 패킷에 있는 프레임 수를 검색합니다.
IAudioCaptureClient::ReleaseBuffer ReleaseBuffer 메서드는 버퍼를 해제합니다.

요구 사항

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

추가 정보

핵심 오디오 인터페이스

IAudioClient::GetMixFormat

IAudioClient::GetService

WASAPI