Platform SDK: DirectX

DirectSoundBuffer.SetFrequency

DirectSoundBuffer.SetFrequency メソッドは、サンプリング オーディオの再生周波数を設定する。

object.SetFrequency(frequency As Long)

パラメータ

object
DirectSoundBuffer オブジェクトを表すオブジェクト式。
frequency
サンプリング オーディオを再生する新しい周波数で、単位はヘルツ (Hz) である。値の範囲は DSBFREQUENCY_MIN (100) から DSBFREQUENCY_MAX (100,000) の間でなければならない。

値が DSBFREQUENCY_ORIGINAL の場合、周波数は現在のバッファ フォーマット内のデフォルト値にリセットされる。このフォーマットは DirectSound.CreateSoundBuffer メソッドで指定されたものである。

エラー コード

失敗すればエラーが発生し、Err.Number に次のいずれかのエラー コードが設定される。

DSERR_CONTROLUNAVAIL
DSERR_GENERIC
DSERR_INVALIDPARAM
DSERR_PRIOLEVELNEEDED

注意

周波数を上下させると、オーディオ データの認識ピッチが変化する。このメソッドはバッファのフォーマットに影響を及ぼさない。

このメソッドはプライマリ サウンド バッファには有効ではない。

参照

DirectSoundBuffer.GetFrequency