waveOutGetPitch 関数 (mmeapi.h)

  • [アーティクル]

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

構文

MMRESULT waveOutGetPitch(
  HWAVEOUT hwo,
  LPDWORD  pdwPitch
);

パラメーター

hwo

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

pdwPitch

現在のピッチ乗数の設定で塗りつぶされる変数へのポインター。 ピッチ乗数は、元のオーサリング設定からのピッチの現在の変化を示します。 ピッチ乗数は正の値である必要があります。

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

戻り値

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

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

解説

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

要件

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

関連項目

波形オーディオ

波形関数