方法 : XAudio2 にオーディオデータファイルを読み込む

[アーティクル]
11/21/2024

Note

このコンテンツはデスクトップアプリにのみ適用され (UWP アプリで機能するためにはリビジョンが必要になり) ます。 CreateFile2、CreateEventEx、WaitForSingleObjectEx、SetFilePointerEx および GetOverlappedResultEx のドキュメントを参照してください。現在アーカイブされている Windows SDK サンプルギャラリーの BasicSound Windows 8 サンプルアプリで SoundFileReader.h と.cpp を参照してください。

XAudio2 でオーディオデータを再生するために必要な構造体を設定するには:

オーディオファイルを読み込み込むかストリーミングを行います。
または、独自の波形を生成し、その波形をバッファー内のサンプルとして表すことができます (「単純な XAudio2 プロジェクト (完全版)」を参照してください)。

このトピックでは、オーディオファイルを読み込む方法について説明します。次の手順では、オーディオファイルの fmt と data のチャンクを読み込み、それらを使用して WAVEFORMATEXTENSIBLE 構造体と XAUDIO2_BUFFER 構造体を設定します。

オーディオファイルの解析準備

XAudio2 でサポートされているオーディオファイルは、リソース交換ファイル形式 (RIFF) で書式設定されます。 RIFF の説明については、トピック「リソース交換ファイル形式 (RIFF）」を参照してください。 RIFF ファイル内のオーディオデータは、RIFF チャンクを検索した後、RIFF チャンクに含まれる個々のチャンクを見つけるためにチャンクをループすることで読み込まれます。次の関数は、チャンクを検索し、そのチャンクに含まれるデータを読み込むコードの例です。

RIFF ファイルでチャンクを検索するには:

#ifdef _XBOX //Big-Endian
#define fourccRIFF 'RIFF'
#define fourccDATA 'data'
#define fourccFMT 'fmt '
#define fourccWAVE 'WAVE'
#define fourccXWMA 'XWMA'
#define fourccDPDS 'dpds'
#endif

#ifndef _XBOX //Little-Endian
#define fourccRIFF 'FFIR'
#define fourccDATA 'atad'
#define fourccFMT ' tmf'
#define fourccWAVE 'EVAW'
#define fourccXWMA 'AMWX'
#define fourccDPDS 'sdpd'
#endif
HRESULT FindChunk(HANDLE hFile, DWORD fourcc, DWORD & dwChunkSize, DWORD & dwChunkDataPosition)
{
    HRESULT hr = S_OK;
    if( INVALID_SET_FILE_POINTER == SetFilePointer( hFile, 0, NULL, FILE_BEGIN ) )
        return HRESULT_FROM_WIN32( GetLastError() );

    DWORD dwChunkType;
    DWORD dwChunkDataSize;
    DWORD dwRIFFDataSize = 0;
    DWORD dwFileType;
    DWORD bytesRead = 0;
    DWORD dwOffset = 0;

    while (hr == S_OK)
    {
        DWORD dwRead;
        if( 0 == ReadFile( hFile, &dwChunkType, sizeof(DWORD), &dwRead, NULL ) )
            hr = HRESULT_FROM_WIN32( GetLastError() );

        if( 0 == ReadFile( hFile, &dwChunkDataSize, sizeof(DWORD), &dwRead, NULL ) )
            hr = HRESULT_FROM_WIN32( GetLastError() );

        switch (dwChunkType)
        {
        case fourccRIFF:
            dwRIFFDataSize = dwChunkDataSize;
            dwChunkDataSize = 4;
            if( 0 == ReadFile( hFile, &dwFileType, sizeof(DWORD), &dwRead, NULL ) )
                hr = HRESULT_FROM_WIN32( GetLastError() );
            break;

        default:
            if( INVALID_SET_FILE_POINTER == SetFilePointer( hFile, dwChunkDataSize, NULL, FILE_CURRENT ) )
            return HRESULT_FROM_WIN32( GetLastError() );            
        }

        dwOffset += sizeof(DWORD) * 2;

        if (dwChunkType == fourcc)
        {
            dwChunkSize = dwChunkDataSize;
            dwChunkDataPosition = dwOffset;
            return S_OK;
        }

        dwOffset += dwChunkDataSize;

        if (bytesRead >= dwRIFFDataSize) return S_FALSE;

    }

    return S_OK;
}

チャンク内のデータを見つけた後に読み取るには。

目的のチャンクが見つかったら、チャンクのデータセクションの先頭にファイルポインターを調整することで、そのデータを読み取ることができます。チャンクが見つかったらチャンクからデータを読み取る関数は、次のようになります。

HRESULT ReadChunkData(HANDLE hFile, void * buffer, DWORD buffersize, DWORD bufferoffset)
{
    HRESULT hr = S_OK;
    if( INVALID_SET_FILE_POINTER == SetFilePointer( hFile, bufferoffset, NULL, FILE_BEGIN ) )
        return HRESULT_FROM_WIN32( GetLastError() );
    DWORD dwRead;
    if( 0 == ReadFile( hFile, buffer, buffersize, &dwRead, NULL ) )
        hr = HRESULT_FROM_WIN32( GetLastError() );
    return hr;
}

XAudio2 構造体に RIFF チャンクの内容を設定する

XAudio2 がソース音声でオーディオを再生するには、WAVEFORMATEX 構造体と XAUDIO2_BUFFER 構造体が必要です。 WAVEFORMATEX 構造体は、最初のメンバーとして WAVEFORMATEX 構造体を含む WAVEFORMATEXTENSIBLE などの大きな構造体である場合があります。詳細については、WAVEFORMATEX リファレンスページを参照してください。

この例では、WAVEFORMATEXTENSIBLE を使用して、2 つ以上のチャネルを持つ PCM オーディオファイルの読み込みを許可します。

次の手順では、上記の関数を使用して、WAVEFORMATEXTENSIBLE 構造体と XAUDIO2_BUFFER 構造体を設定する方法を示しています。この場合、読み込まれるオーディオファイルには PCM データが含まれ、"RIFF"、"fmt"、および "data" のチャンクのみが含まれます。他の形式には、「リソース交換ファイル形式（RIFF）」で説明されているように追加のチャンクの種類が含まれる場合があります。

WAVEFORMATEXTENSIBLE 構造体および XAUDIO2_BUFFER 構造体を宣言します。
```
WAVEFORMATEXTENSIBLE wfx = {0};
XAUDIO2_BUFFER buffer = {0};
```

CreateFile でオーディオファイルを開きます。

#ifdef _XBOX
char * strFileName = "game:\\media\\MusicMono.wav";
#else
TCHAR * strFileName = _TEXT("media\\MusicMono.wav");
#endif
// Open the file
HANDLE hFile = CreateFile(
    strFileName,
    GENERIC_READ,
    FILE_SHARE_READ,
    NULL,
    OPEN_EXISTING,
    0,
    NULL );

if( INVALID_HANDLE_VALUE == hFile )
    return HRESULT_FROM_WIN32( GetLastError() );

if( INVALID_SET_FILE_POINTER == SetFilePointer( hFile, 0, NULL, FILE_BEGIN ) )
    return HRESULT_FROM_WIN32( GetLastError() );

オーディオファイル内で "RIFF" チャンクを見つけて、ファイルの種類を確認します。

DWORD dwChunkSize;
DWORD dwChunkPosition;
//check the file type, should be fourccWAVE or 'XWMA'
FindChunk(hFile,fourccRIFF,dwChunkSize, dwChunkPosition );
DWORD filetype;
ReadChunkData(hFile,&filetype,sizeof(DWORD),dwChunkPosition);
if (filetype != fourccWAVE)
    return S_FALSE;

"fmt" チャンクを見つけて、その内容を WAVEFORMATEXTENSIBLE 構造体にコピーします。

FindChunk(hFile,fourccFMT, dwChunkSize, dwChunkPosition );
ReadChunkData(hFile, &wfx, dwChunkSize, dwChunkPosition );

"data" チャンクを見つけて、その内容をバッファーに読み取ります。

//fill out the audio data buffer with the contents of the fourccDATA chunk
FindChunk(hFile,fourccDATA,dwChunkSize, dwChunkPosition );
BYTE * pDataBuffer = new BYTE[dwChunkSize];
ReadChunkData(hFile, pDataBuffer, dwChunkSize, dwChunkPosition);

XAUDIO2_BUFFER 構造体を設定します。

buffer.AudioBytes = dwChunkSize;  //size of the audio buffer in bytes
buffer.pAudioData = pDataBuffer;  //buffer containing audio data
buffer.Flags = XAUDIO2_END_OF_STREAM; // tell the source voice not to expect any data after this buffer

次の方法で共有

方法 : XAudio2 にオーディオデータファイルを読み込む

オーディオファイルの解析準備

XAudio2 構造体に RIFF チャンクの内容を設定する

フィードバック

その他のリソース

次の方法で共有

方法 : XAudio2 にオーディオ データ ファイルを読み込む

オーディオ ファイルの解析準備

XAudio2 構造体に RIFF チャンクの内容を設定する

関連トピック

フィードバック

その他のリソース

方法 : XAudio2 にオーディオデータファイルを読み込む

オーディオファイルの解析準備