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

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

構文

HRESULT VolumeStepUp(
  [in] LPCGUID pguidEventContext
);

パラメーター

[in] pguidEventContext

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

戻り値

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

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

解説

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

ボリューム レベルが既にボリューム範囲内で最も高いステップにある場合、 VolumeStepUp の呼び出しは無効であり、状態コード S_OKを返します。

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

要件

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

関連項目

IAudioEndpointVolume インターフェイス

IAudioEndpointVolume::GetVolumeStepInfo

IAudioEndpointVolumeCallback インターフェイス

IAudioEndpointVolumeCallback::OnNotify