次の方法で共有


IDirectSoundBuffer8::SetFrequency

SetFrequency メソッドは、オーディオ サンプルの再生周波数を設定します。

HRESULT 
SetFrequency(
  DWORD dwFrequency
);

パラメータ

  • dwFrequency
    サンプリング オーディオを再生する周波数 (Hz 単位) です。値 DSBFREQUENCY_ORIGINAL を指定すると、周波数はバッファー フォーマットのデフォルト値にリセットされます。

戻り値

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

リターン コード
DSERR_CONTROLUNAVAIL
DSERR_GENERIC
DSERR_INVALIDPARAM
DSERR_PRIOLEVELNEEDED

解説 

周波数を上下させると、オーディオ データの知覚ピッチが変化します。このメソッドは、バッファーのフォーマットには影響しません。

周波数を設定する前に、デバイスについて DSCAPS 構造体の dwMinSecondarySampleRate メンバーと dwMaxSecondarySampleRate メンバーを調べて、その周波数がサポートされているかどうかを確認する必要があります。一部のオペレーティング システムは、100,000 Hz を超える周波数をサポートしていません。

このメソッドは、プライマリ バッファーには無効です。

要件

ヘッダー: DSound.h 宣言

ライブラリ: Dsound3d.dll 内容

関連項目

IDirectSoundBuffer8