Microsoft DirectX 8.0 (C++)

IDirectSoundBuffer8::SetFrequency

サンプリング オーディオの再生周波数を設定する。

HRESULT SetFrequency(
  DWORD dwFrequency 
);

パラメータ

dwFrequency
サンプリング オーディオを再生する新しい周波数 (Hz 単位)。値の範囲は DSBFREQUENCY_MIN から DSBFREQUENCY_MAX の間でなければならない。現在これらの値は dsound.h 内で、それぞれ 100、100,000 と定義されている。

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

戻り値

成功した場合は DS_OK を返す。

失敗した場合は、次のいずれかのエラー値を返す。

DSERR_CONTROLUNAVAIL
DSERR_GENERIC
DSERR_INVALIDPARAM
DSERR_PRIOLEVELNEEDED

注意

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

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

動作環境

  ヘッダー : dsound.h で宣言。

参照

IDirectSound8::CreateSoundBufferIDirectSoundBuffer8::GetFrequencyIDirectSoundBuffer8::PlayIDirectSoundBuffer8::SetFormat