waveOutUnprepareHeader 函式 (mmeapi.h)

waveOutUnprepareHeader函式會清除waveOutPrepareHeader函式所執行的準備。在設備磁碟機完成資料區塊之後，必須呼叫此函式。您必須先呼叫此函式，才能釋放緩衝區。

語法

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

hwo

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

pwh

WAVEHDR結構的指標，識別要清除的資料區塊。

cbwh

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

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

此函式補充 waveOutPrepareHeader。您必須先呼叫此函式，才能釋放緩衝區。使用 waveOutWrite 函式將緩衝區傳遞至設備磁碟機之後，您必須等到驅動程式在呼叫 waveOutUnprepareHeader之前，先等候該緩衝區完成。

取消準備尚未準備的緩衝區沒有任何作用，而且函式會傳回零。