waveOutReset 函式 (mmeapi.h)

waveOutReset函式會停止在指定的電壓音訊輸出裝置上播放，並將目前位置重設為零。 所有擱置的播放緩衝區都會標示為完成 (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)
程式庫	Winmm.lib
Dll	Winmm.dll

另請參閱

電壓音訊

電壓函數