IAudioCaptureClient-Schnittstelle (audioclient.h)

Mit der IAudioCaptureClient-Schnittstelle kann ein Client Eingabedaten aus einem Erfassungsendpunktpuffer lesen. Der Client ruft einen Verweis auf die IAudioCaptureClient-Schnittstelle für ein Streamobjekt ab, indem er die IAudioClient::GetService-Methode aufruft, wobei der Parameter riid auf REFIID IID_IAudioCaptureClient festgelegt ist.

Die Methoden in dieser Schnittstelle verwalten die Verschiebung von Datenpaketen, die Erfassungsdaten enthalten. Die Länge eines Datenpakets wird als die Anzahl der Audioframes im Paket ausgedrückt. Die Größe eines Audioframes wird durch den nBlockAlign-Member der WAVEFORMATEX-Struktur (oder WAVEFORMATEXTENSIBLE) angegeben, die der Client durch Aufrufen der IAudioClient::GetMixFormat-Methode erhält. Die Größe eines Audioframes in Bytes entspricht der Anzahl von Kanälen im Stream multipliziert mit der Beispielgröße pro Kanal. Beispielsweise beträgt die Framegröße vier Bytes für einen Stereodatenstrom (2 Kanäle) mit 16-Bit-Beispielen. Ein Paket enthält immer eine integrale Anzahl von Audioframes.

Beim Freigeben einer IAudioCaptureClient-Schnittstelle instance muss der Client die Release-Methode des instance aus demselben Thread aufrufen wie der Aufruf von IAudioClient::GetService, von dem das Objekt erstellt wurde.

Ein Codebeispiel, das die IAudioCaptureClient-Schnittstelle verwendet, finden Sie unter Erfassen einer Stream.

Vererbung

Die IAudioCaptureClient-Schnittstelle erbt von der IUnknown-Schnittstelle . IAudioCaptureClient verfügt auch über folgende Arten von Membern:

Methoden

Die IAudioCaptureClient-Schnittstelle verfügt über diese Methoden.

IAudioCaptureClient::GetBuffer Ruft einen Zeiger auf das nächste verfügbare Datenpaket im Erfassungsendpunktpuffer ab.
IAudioCaptureClient::GetNextPacketSize Die GetNextPacketSize-Methode ruft die Anzahl der Frames im nächsten Datenpaket im Erfassungsendpunktpuffer ab.
IAudioCaptureClient::ReleaseBuffer Die ReleaseBuffer-Methode gibt den Puffer frei.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	audioclient.h

Weitere Informationen

Kern-Audioschnittstellen

IAudioClient::GetMixFormat

IAudioClient::GetService

WASAPI