IAudioSessionManager::GetSimpleAudioVolume メソッド (audiopolicy.h)

  • [アーティクル]

GetSimpleAudioVolume メソッドは、単純なオーディオ ボリューム コントロールを取得します。

構文

HRESULT GetSimpleAudioVolume(
  [in]  LPCGUID            AudioSessionGuid,
  [in]  DWORD              StreamFlags,
  [out] ISimpleAudioVolume **AudioVolume
);

パラメーター

[in] AudioSessionGuid

セッション GUID へのポインター。 以前に開いたセッションが GUID によって識別されない場合、呼び出しによって新しい空のセッションが開かれます。 Sndvol プログラムには、1 つ以上のアクティブなストリームが含まれていない限り、セッションのボリューム レベルコントロールは表示されません。 このパラメーターが NULL であるか、GUID_NULL値を指している場合、メソッドはストリームを既定のセッションに割り当てます。

[in] StreamFlags

要求がクロスプロセス セッション用かどうかを指定します。 セッションがクロスプロセスの場合は TRUE に 設定します。 セッションがクロスプロセスでない場合は FALSE に 設定します。

[out] AudioVolume

メソッドがオーディオ ボリューム コントロール オブジェクトの ISimpleAudioVolume インターフェイスへのポインターを書き込むポインター変数へのポインター。 このインターフェイスは、現在のプロセスの単純なオーディオ ボリュームコントロールを表します。 呼び出し元は、インターフェイスの Release メソッドを呼び出すことによって、不要になったときにインターフェイスを 解放 する役割を担います。 Activate 呼び出しが失敗した場合、*AudioVolume は NULL です。

戻り値

メソッドが成功した場合は、S_OK を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。

リターン コード 説明
AUDCLNT_E_NOT_INITIALIZED
 オーディオ ストリームが正常に初期化されていません。
AUDCLNT_E_DEVICE_INVALIDATED
 オーディオ エンドポイント デバイスが取り外されているか、オーディオ ハードウェアまたは関連するハードウェア リソースが再構成、無効、削除、またはその他の方法で使用できなくなります。
AUDCLNT_E_SERVICE_NOT_RUNNING
 Windows オーディオ サービスが実行されていません。
E_POINTER
 パラメーター AudioVolume が NULL です。
E_MEMORY
 メモリが不足しています。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー audiopolicy.h

こちらもご覧ください

IAudioSessionManager インターフェイス

ISimpleAudioVolume インターフェイス