waveOutPrepareHeader 函式 (mmeapi.h)

waveOutPrepareHeader函式會準備用於播放的波浪音訊資料區塊。

語法

MMRESULT waveOutPrepareHeader(
  HWAVEOUT  hwo,
  LPWAVEHDR pwh,
  UINT      cbwh
);

hwo

對電壓音訊輸出裝置的控制碼。

pwh

WAVEHDR結構的指標，可識別要準備的資料區塊。

cbwh

WAVEHDR結構的大小，以位元組為單位。

如果成功或發生錯誤，則傳回 MMSYSERR_NOERROR 。可能的錯誤值包括下列專案。

呼叫此函式之前，請先設定WAVEHDR結構的lpData、dwBufferLength和dwFlags成員。將 dwFlags 成員設定為零。

WAVEHDR結構的dwFlags、dwBufferLength和dwLoops成員可以在呼叫此函式和waveOutWrite函式之間變更。如果您在呼叫 waveOutWrite之前變更dwBufferLength所指定的大小，則新值必須小於備妥的值。

如果方法成功，則會在WAVEHDR結構的dwFlags成員中設定WHDR_PREPARED旗標。

準備已經備妥的標頭沒有任何作用，而且函式會傳回零。