waveOutReset 関数 (mmeapi.h)

  • [アーティクル]

waveOutReset 関数は、指定された波形オーディオ出力デバイスでの再生を停止し、現在の位置を 0 にリセットします。 保留中のすべての再生バッファーは完了としてマークされ (WHDR_DONE)、アプリケーションに返されます。

構文

MMRESULT waveOutReset(
  HWAVEOUT hwo
);

パラメーター

hwo

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

戻り値

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

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

解説

この関数が戻った後、アプリケーションは waveOutWrite を呼び出してデバイスに新しい再生バッファーを送信するか、 waveOutClose を呼び出してデバイスを閉じます。

要件

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

関連項目

波形オーディオ

波形関数