IAudioClient-Schnittstelle (audioclient.h)

  • Artikel

Mit der IAudioClient-Schnittstelle kann ein Client einen Audiodatenstrom zwischen einer Audioanwendung und der Audio-Engine (für einen Stream im freigegebenen Modus) oder dem Hardwarepuffer eines Audioendpunktgeräts (für einen Datenstrom im exklusiven Modus) erstellen und initialisieren. Ein Client ruft einen Verweis auf eine IAudioClient-Schnittstelle für ein Audioendpunktgerät ab, indem er die folgenden Schritte ausführt:

  1. Rufen Sie mithilfe einer der unter IMMDevice Interface beschriebenen Techniken einen Verweis auf die IMMDevice-Schnittstelle für ein Audioendpunktgerät ab.
  2. Rufen Sie die IMMDevice::Activate-Methode auf, wobei parameter iid auf REFIID IID_IAudioClient festgelegt ist.

Der Anwendungsthread, der diese Schnittstelle verwendet, muss für COM initialisiert werden. Weitere Informationen zur COM-Initialisierung finden Sie in der Beschreibung der CoInitializeEx-Funktion in der Windows SDK-Dokumentation.

Codebeispiele, die die IAudioClient-Schnittstelle verwenden, finden Sie in den folgenden Themen:

Vererbung

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

Methoden

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

 
IAudioClient::GetBufferSize

Die GetBufferSize-Methode ruft die Größe (maximale Kapazität) des Endpunktpuffers ab.
IAudioClient::GetCurrentPadding

Die GetCurrentPadding-Methode ruft die Anzahl der Frames im Endpunktpuffer ab.
IAudioClient::GetDevicePeriod

Die GetDevicePeriod-Methode ruft die Länge des periodischen Intervalls ab, das die aufeinanderfolgenden Verarbeitungsdurchläufe von der Audio-Engine für die Daten im Endpunktpuffer trennt.
IAudioClient::GetMixFormat

Die GetMixFormat-Methode ruft das Streamformat ab, das die Audio-Engine für die interne Verarbeitung von Datenströmen im freigegebenen Modus verwendet.
IAudioClient::GetService

Die GetService-Methode greift über das Audioclientobjekt auf zusätzliche Dienste zu.
IAudioClient::GetStreamLatency

Die GetStreamLatency-Methode ruft die maximale Latenz für den aktuellen Stream ab und kann jederzeit aufgerufen werden, nachdem der Stream initialisiert wurde.
IAudioClient::Initialize

Die Initialize-Methode initialisiert den Audiodatenstrom.
IAudioClient::IsFormatSupported

Die IsFormatSupported-Methode gibt an, ob das Audioendpunktgerät ein bestimmtes Streamformat unterstützt.
IAudioClient::Reset

Die Reset-Methode setzt den Audiostream zurück.
IAudioClient::SetEventHandle

Die SetEventHandle-Methode legt das Ereignishandle fest, das das System signalisiert, wenn ein Audiopuffer bereit ist, vom Client verarbeitet zu werden.
IAudioClient::Start

Die Start-Methode startet den Audiostream.
IAudioClient::Stop

Die Stop-Methode beendet den Audiodatenstrom.

Hinweise

Hinweis In Windows 8 sollte die erste Verwendung von IAudioClient für den Zugriff auf das Audiogerät im STA-Thread erfolgen. Aufrufe von einem MTA-Thread können zu undefiniertem Verhalten führen.
 

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

IMMDevice::Activate

WASAPI