EndpointVolume

Diese Beispielanwendung verwendet die Core-Audio-APIs, um die Lautstärke des Geräts zu ändern, wie vom Benutzer angegeben.

Dieses Thema enthält folgende Abschnitte:

• Beschreibung
• Anforderungen
• Herunterladen des Beispiels
• Erstellen des Beispiels
• Ausführen des Beispiels
• Zugehörige Themen

BESCHREIBUNG

In diesem Beispiel werden die folgenden Features veranschaulicht.

• MMDevice-API für die Enumeration und Auswahl von Multimediageräten.
• EndpointVolume-API zum Steuern der Lautstärke des Geräteendpunkts.

Anforderungen

Produkt	Version
Windows SDK	Windows 7
Visual Studio	2008

 

Herunterladen des Beispiels

Dieses Beispiel ist an den folgenden Speicherorten verfügbar.

Standort	Pfad/URL
Windows SDK	\Programme\Microsoft SDKs\Windows\v7.0\Samples\Multimedia\Audio\EndpointVolume\...

 

Erstellen des Beispiels

Führen Sie zum Erstellen des x-Beispiels die folgenden Schritte aus:

Führen Sie zum Erstellen des EndpointVolumeChanger-Beispiels die folgenden Schritte aus:

1. Öffnen Sie die CMD-Shell für das Windows SDK, und wechseln Sie zum Beispielverzeichnis EndpointVolume.
2. Führen Sie den Befehl start EndpointVolumeChanger.sln im Verzeichnis EndpointVolume aus, um das Projekt EndpointVolumeChanger im Visual Studio-Fenster zu öffnen.
3. Wählen Sie im Fenster die Projektmappenkonfiguration Debuggen oder Freigeben aus, wählen Sie in der Menüleiste das Menü Erstellen und dann die Option Erstellen aus. Wenn Sie Visual Studio nicht über die CMD-Shell für das SDK öffnen, hat Visual Studio keinen Zugriff auf die SDK-Buildumgebung. In diesem Fall wird das Beispiel nur erstellt, wenn Sie die Umgebungsvariable MSSdk explizit festlegen, die in der Projektdatei WASAPIEndpointVolume.vcproj verwendet wird.

Ausführen des Beispiels

Wenn Sie die Demoanwendung erfolgreich erstellen, wird eine ausführbare Datei EndpointVolumeChanger.exe generiert. Geben EndpointVolumeChanger Sie zum Ausführen in ein Befehlsfenster gefolgt von erforderlichen oder optionalen Argumenten ein. Das folgende Beispiel zeigt, wie Sie die Stummschaltungseinstellung auf dem Standardkonsolengerät umschalten.

EndpointVolumeChanger.exe -console -m

In der folgenden Tabelle sind die Argumente aufgeführt.

Argument	BESCHREIBUNG
-?	Zeigt Hilfe an.
-H	Zeigt Hilfe an.
-+	Erhöht die Lautstärke auf dem Audioendpunktgerät um einen Schritt. .
-up	Erhöht die Lautstärke auf dem Audioendpunktgerät um einen Schritt.
--	Verringert die Lautstärke auf dem Audioendpunktgerät um einen Schritt.
-down	Verringert die Lautstärke auf dem Audioendpunktgerät um einen Schritt.
-v	Legt die master Lautstärke auf dem Audioendpunktgerät fest.
-Konsole	Verwenden Sie das Standardkonsolengerät.
-Kommunikation	Verwenden Sie das Standardkommunikationsgerät.
-Multimedia	Verwenden Sie das Standard-Multimediagerät.
-Endpunkt	Verwenden Sie den im Switchwert angegebenen Endpunktbezeichner.

 

Wenn die Anwendung ohne Argumente ausgeführt wird, listet sie die verfügbaren Geräte auf und fordert den Benutzer auf, ein Gerät auszuwählen. Nachdem der Benutzer das Gerät angegeben hat, zeigt die Anwendung die aktuellen Volumeeinstellungen für den Endpunkt an. Die Lautstärke kann mithilfe der in der vorherigen Tabelle beschriebenen Schalter gesteuert werden.

Weitere Informationen zum Steuern der Lautstärkepegel von Audioendpunktgeräten finden Sie unter EndpointVolume-API.

Zugehörige Themen

SDK-Beispiele, die die Kernaudio-APIs verwenden