IDirectSoundBuffer8::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 で宣言。
参照