IAudioClient-Schnittstelle (audioclient.h)
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:
- Rufen Sie mithilfe einer der unter IMMDevice Interface beschriebenen Techniken einen Verweis auf die IMMDevice-Schnittstelle für ein Audioendpunktgerät ab.
- 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
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 |