WAVEHDR 結構 (mmeapi.h)

WAVEHDR 結構會定義用來識別電壓音頻緩衝區的標頭。

語法

typedef struct wavehdr_tag {
  LPSTR              lpData;
  DWORD              dwBufferLength;
  DWORD              dwBytesRecorded;
  DWORD_PTR          dwUser;
  DWORD              dwFlags;
  DWORD              dwLoops;
  struct wavehdr_tag *lpNext;
  DWORD_PTR          reserved;
} WAVEHDR, *PWAVEHDR, *NPWAVEHDR, *LPWAVEHDR;

成員

lpData

對電壓緩衝區的指標。

dwBufferLength

緩衝區的長度，以位元組為單位。

dwBytesRecorded

當標頭用於輸入時，指定緩衝區中的數據量。

dwUser

用戶數據。

dwFlags

零個或多個旗標的位 OR 。 定義下列旗標：

名稱	描述
WHDR_BEGINLOOP	這個緩衝區是迴圈中的第一個緩衝區。 此旗標只會與輸出緩衝區搭配使用。
WHDR_DONE	由設備驅動器設定，以指出它已完成緩衝區，並將它傳回至應用程式。
WHDR_ENDLOOP	這個緩衝區是迴圈中的最後一個緩衝區。 此旗標只會與輸出緩衝區搭配使用。
WHDR_INQUEUE	由 Windows 設定，表示緩衝區已排入佇列以供播放。
WHDR_PREPARED	由 Windows 設定，以指出已使用 waveInPrepareHeader 或 waveOutPrepareHeader 函式來準備緩衝區。

dwLoops

播放循環的次數。 這個成員只會與輸出緩衝區搭配使用。

lpNext

保留的。

reserved

保留的。

備註

使用 dwFlags 成員中的WHDR_BEGINLOOP和WHDR_ENDLOOP旗標來指定迴圈的開始和結束數據區塊。 若要在單一區塊上迴圈，請指定相同區塊的兩個旗標。 針對迴圈中第一個區塊使用 WAVEHDR 結構中的 dwLoops 成員，以指定播放迴圈的次數。

呼叫 waveInPrepareHeader 或 waveOutPrepareHeader 函式之前，必須先設定 lpData、dwBufferLength 和 dwFlags 成員。 (針對任一函式， dwFlags 成員必須設定為 zero.)

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	mmeapi.h (包含 Windows.h)

另請參閱

波波音頻

波形結構

waveInPrepareHeader

waveOutPrepareHeader