waveOutReset 関数 (mmeapi.h)
waveOutReset 関数は、指定された波形オーディオ出力デバイスでの再生を停止し、現在の位置を 0 にリセットします。 保留中のすべての再生バッファーは完了としてマークされ (WHDR_DONE)、アプリケーションに返されます。
構文
MMRESULT waveOutReset(
HWAVEOUT hwo
);
パラメーター
hwo
波形オーディオ出力デバイスへのハンドル。
戻り値
成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
指定されたデバイス ハンドルが無効です。 |
|
デバイス ドライバーが存在しません。 |
|
メモリを割り当てまたはロックできません。 |
|
指定されたデバイスは同期であり、一時停止をサポートしていません。 |
解説
この関数が戻った後、アプリケーションは waveOutWrite を呼び出してデバイスに新しい再生バッファーを送信するか、 waveOutClose を呼び出してデバイスを閉じます。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mmeapi.h (Windows.h を含む) |
| Library | Winmm.lib |
| [DLL] | Winmm.dll |