方法: XAudio2 でのオーディオデータファイルの読み込み

[アーティクル]
06/13/2023

注意

このコンテンツはデスクトップアプリにのみ適用され、Windows ストアアプリで機能するにはリビジョンが必要です。 CreateFile2、CreateEventEx、WaitForSingleObjectEx、SetFilePointerEx、GetOverlappedResultEx のドキュメントを参照してください。 Windows SDK サンプルギャラリーの BasicSound Windows 8 サンプルの SoundFileReader.h/.cpp を参照してください。

このトピックでは、XAudio2 でオーディオデータを再生するために必要な構造体を設定する手順について説明します。次の手順では、オーディオファイルの 'fmt ' と 'data' のチャンクを読み込み、それらを使用して WAVEFORMATEXTENSIBLE 構造体と XAUDIO2_BUFFER 構造体を設定します。

オーディオファイルを解析する準備をしています。
XAudio2 構造体に RIFF チャンクの内容を設定する。

オーディオファイルを解析する準備

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 プログラミングリファレンス

Share via

方法: XAudio2 でのオーディオデータファイルの読み込み

オーディオファイルを解析する準備

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

フィードバック

フィードバック

その他のリソース

Share via

方法: XAudio2 でのオーディオ データ ファイルの読み込み

オーディオ ファイルを解析する準備

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

関連トピック

フィードバック

フィードバック

その他のリソース

方法: XAudio2 でのオーディオデータファイルの読み込み

オーディオファイルを解析する準備