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 内容