waveOutSetPitch 関数 (mmeapi.h)

  • [アーティクル]

waveOutSetPitch 関数は、指定された波形オーディオ出力デバイスのピッチを設定します。

構文

MMRESULT waveOutSetPitch(
  HWAVEOUT hwo,
  DWORD    dwPitch
);

パラメーター

hwo

波形オーディオ出力デバイスへのハンドル。

dwPitch

新しいピッチ乗数の設定。 この設定は、元の作成された設定からのピッチの現在の変更を示します。 ピッチ乗数は正の値である必要があります。

ピッチ乗数は固定小数点値として指定されます。 上位ワードには数値の符号付き整数部分が含まれており、下位ワードには小数部が含まれます。 下位ワードの 0x8000 の値は 1/2 を表し、0x4000は 4 分の 1 を表します。 たとえば、値0x00010000は 1.0 の乗数 (ピッチの変更なし) を指定し、値0x000F8000は 15.5 の乗数を指定します。

戻り値

成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。

リターン コード 説明
MMSYSERR_INVALHANDLE
 指定されたデバイス ハンドルが無効です。
MMSYSERR_NODRIVER
 デバイス ドライバーが存在しません。
MMSYSERR_NOMEM
 メモリを割り当てまたはロックできません。
MMSYSERR_NOTSUPPORTED
 関数はサポートされていません。

注釈

ピッチを変更しても、再生レートやサンプルレートは変更されず、再生時間も変更されません。 すべてのデバイスでピッチの変更がサポートされているわけではありません。 デバイスがピッチ制御をサポートしているかどうかを判断するには、WAVECAPS_PITCH フラグを使用して、WAVEOUTCAPS 構造体 (waveOutGetDevCaps 関数で塗りつぶされた) の dwSupport メンバーをテストします。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mmeapi.h (Windows.h を含む)
Library Winmm.lib
[DLL] Winmm.dll

こちらもご覧ください

波形オーディオ

波形関数