IAudioEndpointVolume::VolumeStepDown メソッド (endpointvolume.h)
VolumeStepDown メソッドは、オーディオ エンドポイント デバイスに出入りするオーディオ ストリームのボリューム レベルを 1 ステップでデクリメントします。
構文
HRESULT VolumeStepDown(
[in] LPCGUID pguidEventContext
);
パラメーター
[in] pguidEventContext
IAudioEndpointVolumeCallback::OnNotify メソッドのコンテキスト値。 このパラメーターは、イベント コンテキスト GUID を指します。 VolumeStepDown 呼び出しによってエンドポイントのボリューム レベルが変更された場合、そのエンドポイントに IAudioEndpointVolumeCallback インターフェイスを登録したすべてのクライアントに通知が送信されます。 OnNotify メソッドの実装では、クライアントはイベント コンテキスト GUID を検査して、それがボリューム変更イベントのソースであるかどうかを検出できます。 呼び出し元がこのパラメーターに NULL ポインターを指定した場合、クライアントの通知メソッドは NULL コンテキスト ポインターを受け取ります。
戻り値
メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。
| リターン コード | 説明 |
|---|---|
|
メモリが不足しています。 |
注釈
現在のボリューム ステップとボリューム範囲内のステップの合計数を取得するには、 IAudioEndpointVolume::GetVolumeStepInfo メソッドを呼び出します。
ボリューム レベルが既にボリューム範囲の最も低いステップにある場合、 VolumeStepDown の呼び出しは影響を受けず、状態コードS_OKを返します。
隣接するステップ間の連続した間隔は、必ずしも線形信号振幅またはデシベルのいずれかで均一なボリューム増分を表すわけではありません。 Windows Vista では、 VolumeStepDown は、ステップ インデックスとボリューム レベル (信号振幅) の関係をオーディオテーパ曲線として定義します。 今後のバージョンの Windows では、曲線の形状が変わる可能性があることに注意してください。 オーディオテーパカーブの詳細については、「 Audio-Tapered Volume Controls」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | endpointvolume.h |
こちらもご覧ください
IAudioEndpointVolume::GetVolumeStepInfo