IAudioEndpointVolume::VolumeStepDown メソッド (endpointvolume.h)

  • [アーティクル]

VolumeStepDown メソッドは、オーディオ エンドポイント デバイスに出入りするオーディオ ストリームのボリューム レベルを 1 ステップでデクリメントします。

構文

HRESULT VolumeStepDown(
  [in] LPCGUID pguidEventContext
);

パラメーター

[in] pguidEventContext

IAudioEndpointVolumeCallback::OnNotify メソッドのコンテキスト値。 このパラメーターは、イベント コンテキスト GUID を指します。 VolumeStepDown 呼び出しによってエンドポイントのボリューム レベルが変更された場合、そのエンドポイントに IAudioEndpointVolumeCallback インターフェイスを登録したすべてのクライアントに通知が送信されます。 OnNotify メソッドの実装では、クライアントはイベント コンテキスト GUID を検査して、それがボリューム変更イベントのソースであるかどうかを検出できます。 呼び出し元がこのパラメーターに NULL ポインターを指定した場合、クライアントの通知メソッドは NULL コンテキスト ポインターを受け取ります。

戻り値

メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。

リターン コード 説明
E_OUTOFMEMORY
 メモリが不足しています。

注釈

現在のボリューム ステップとボリューム範囲内のステップの合計数を取得するには、 IAudioEndpointVolume::GetVolumeStepInfo メソッドを呼び出します。

ボリューム レベルが既にボリューム範囲の最も低いステップにある場合、 VolumeStepDown の呼び出しは影響を受けず、状態コードS_OKを返します。

隣接するステップ間の連続した間隔は、必ずしも線形信号振幅またはデシベルのいずれかで均一なボリューム増分を表すわけではありません。 Windows Vista では、 VolumeStepDown は、ステップ インデックスとボリューム レベル (信号振幅) の関係をオーディオテーパ曲線として定義します。 今後のバージョンの Windows では、曲線の形状が変わる可能性があることに注意してください。 オーディオテーパカーブの詳細については、「 Audio-Tapered Volume Controls」を参照してください。

要件

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

こちらもご覧ください

IAudioEndpointVolume インターフェイス

IAudioEndpointVolume::GetVolumeStepInfo

IAudioEndpointVolumeCallback インターフェイス

IAudioEndpointVolumeCallback::OnNotify