次の方法で共有

EndpointVolume

  • [アーティクル]

このサンプル アプリケーションでは、コア オーディオ API を使用して、ユーザーが指定したデバイスのボリュームを変更します。

このトピックには、次のセクションが含まれています。

形容

このサンプルでは、次の機能を示します。

  • マルチメディア デバイスの列挙と選択のための MMDevice API を します。
  • EndpointVolume API を して、デバイス エンドポイントのボリューム レベルを制御します。

必要条件

積 バージョン
Windows SDK の Windows 7
Visual Studio 2008

 

サンプルのダウンロード

このサンプルは、次の場所にあります。

場所 パス/URL
Windows SDK \Program Files\Microsoft SDK\Windows\v7.0\Samples\Multimedia\Audio\EndpointVolume\...

 

サンプルのビルド

x サンプルをビルドするには、次の手順に従います。

EndpointVolumeChanger サンプルをビルドするには、次の手順に従います。

  1. Windows SDK の CMD シェルを開き、EndpointVolume サンプル ディレクトリに変更します。
  2. EndpointVolume ディレクトリ start EndpointVolumeChanger.sln コマンドを実行して、Visual Studio ウィンドウで EndpointVolumeChanger プロジェクトを開きます。
  3. ウィンドウ内から、デバッグ またはリリース ソリューション構成 選択し、メニュー バーから ビルド メニューを選択し、ビルド オプションを選択します。 SDK の CMD シェルから Visual Studio を開かない場合、Visual Studio は SDK ビルド環境にアクセスできません。 その場合、プロジェクト ファイル WASAPIEndpointVolume.vcproj で使用される環境変数 MSSdk を明示的に設定しない限り、サンプルはビルドされません。

サンプルの実行

デモ アプリケーションを正常にビルドすると、実行可能ファイル (EndpointVolumeChanger.exe) が生成されます。 これを実行するには、コマンド ウィンドウに「EndpointVolumeChanger」と入力し、その後に必須または省略可能な引数を入力します。 次の例は、既定のコンソール デバイスでミュート設定を切り替える方法を示しています。

EndpointVolumeChanger.exe -console -m

次の表に、引数を示します。

引数 形容
-? ヘルプを表示します。
-h ヘルプを表示します。
-+ オーディオ エンドポイント デバイスのボリューム レベルを 1 ステップずつインクリメントします。 .
-上 オーディオ エンドポイント デバイスのボリューム レベルを 1 ステップずつインクリメントします。
-- オーディオ エンドポイント デバイスのボリューム レベルを 1 ステップでデクリメントします。
-下 オーディオ エンドポイント デバイスのボリューム レベルを 1 ステップでデクリメントします。
-v オーディオ エンドポイント デバイスのマスター ボリューム レベルを設定します。
-慰める 既定のコンソール デバイスを使用します。
-通信 既定の通信デバイスを使用します。
-マルチメディア 既定のマルチメディア デバイスを使用します。
-エンドポイント スイッチ値で指定されたエンドポイント識別子を使用します。

 

アプリケーションを引数なしで実行すると、使用可能なデバイスが列挙され、ユーザーにデバイスの選択を求められます。 ユーザーがデバイスを指定すると、アプリケーションはエンドポイントの現在のボリューム設定を表示します。 ボリュームは、前の表で説明したスイッチを使用して制御できます。

オーディオ エンドポイント デバイスのボリューム レベルの制御の詳細については、「EndpointVolume API を参照してください。

コア オーディオ API を使用する SDK サンプルを する