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
0 個以上のフラグのビットごとの OR 。 次のフラグが定義されています。
名前 | 説明 |
---|---|
|
このバッファーは、ループ内の最初のバッファーです。 このフラグは、出力バッファーでのみ使用されます。 |
|
バッファーで終了し、アプリケーションに返されることを示すように、デバイス ドライバーによって設定されます。 |
|
このバッファーは、ループ内の最後のバッファーです。 このフラグは、出力バッファーでのみ使用されます。 |
|
バッファーが再生キューに入っていることを示すように Windows によって設定されます。 |
|
バッファーが waveInPrepareHeader 関数または waveOutPrepareHeader 関数で準備されたことを示すように Windows によって設定されます。 |
dwLoops
ループを再生する回数。 このメンバーは、出力バッファーでのみ使用されます。
lpNext
予約済み。
reserved
予約済み。
注釈
dwFlags メンバーのWHDR_BEGINLOOPフラグとWHDR_ENDLOOP フラグを使用して、ループの開始データ ブロックと終了データ ブロックを指定します。 1 つのブロックでループするには、同じブロックに両方のフラグを指定します。 ループ内の最初のブロックに対して WAVEHDR 構造体の dwLoops メンバーを使用して、ループを再生する回数を指定します。
waveInPrepareHeader 関数または waveOutPrepareHeader 関数を呼び出す前に、lpData、dwBufferLength、および dwFlags メンバーを設定する必要があります。 (どちらの関数の場合も、 dwFlags メンバーを 0 に設定する必要があります)。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
Header | mmeapi.h (Windows.h を含む) |