IAudioClient-Schnittstelle (audioclient.h)
Die IAudioClient--Schnittstelle ermöglicht einem Client das Erstellen und Initialisieren eines Audiodatenstroms zwischen einer Audioanwendung und dem Audiomodul (für einen Datenstrom im gemeinsam genutzten Modus) oder dem Hardwarepuffer eines Audioendpunktgeräts (für einen Exklusivmodusdatenstrom). Ein Client ruft einen Verweis auf eine IAudioClient- Schnittstelle für ein Audioendpunktgerät ab, indem Sie die folgenden Schritte ausführen:
- Rufen Sie mithilfe einer der in IMMDevice Interfacebeschriebenen 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. Ab Windows 10 Build 20348 können Anrufer eine AUDIOCLIENT_ACTIVATION_PARAMS übergeben, um die IAudioClient- für die Loopbackerfassung mit einem Prozessfilter zu konfigurieren.
Der Anwendungsthread, der diese Schnittstelle verwendet, muss für COM initialisiert werden. Weitere Informationen zur COM-Initialisierung finden Sie in der Windows SDK-Dokumentation in der Beschreibung der funktion CoInitializeEx.
Codebeispiele, die die IAudioClient--Schnittstelle verwenden, finden Sie in den folgenden Themen:
Erbschaft
Die IAudioClient Schnittstelle erbt von der IUnknown--Schnittstelle. IAudioClient- verfügt auch über die folgenden Membertypen:
Methodik
Die IAudioClient- Schnittstelle hat 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 des Abstands im Endpunktpuffer ab. |
|
IAudioClient::GetDevicePeriod Die GetDevicePeriod-Methode ruft die Länge des regelmäßigen Intervalls ab, das die aufeinander folgende Verarbeitungsdurchläufe durch das Audiomodul für die Daten im Endpunktpuffer trennt. |
|
IAudioClient::GetMixFormat Die GetMixFormat-Methode ruft das Datenstromformat ab, das das Audiomodul für die interne Verarbeitung von Datenströmen im freigegebenen Modus verwendet. |
|
IAudioClient::GetService Die GetService-Methode greift auf zusätzliche Dienste aus dem Audioclientobjekt zu. |
|
IAudioClient::GetStreamLatency Die GetStreamLatency-Methode ruft die maximale Latenz für den aktuellen Datenstrom ab und kann jederzeit aufgerufen werden, nachdem der Datenstrom 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:: zurücksetzen Die Reset-Methode setzt den Audiodatenstrom zurück. |
|
IAudioClient::SetEventHandle Die SetEventHandle-Methode legt den Ereignishandle fest, den das System signalisiert, wenn ein Audiopuffer bereit ist, vom Client verarbeitet zu werden. |
|
IAudioClient::Start Die Startmethode startet den Audiodatenstrom. |
|
IAudioClient::Stop Die Stop-Methode beendet den Audiodatenstrom. |
Bemerkungen
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | audioclient.h |