方法: ディスクからのサウンドのストリーム

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

注意

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

XAudio2 でオーディオデータをストリーミングするには、別のスレッドを作成し、ストリーミングスレッドでオーディオデータのバッファー読み取りを実行し、コールバックを使用してそのスレッドを制御します。

ストリーミングスレッドでのバッファー読み取りの実行
コールバッククラスの作成

ストリーミングスレッドでのバッファー読み取りの実行

ストリーミングスレッドでバッファー読み取りを実行するには、次の手順に従います。

読み取りバッファーの配列を作成します。

#define STREAMING_BUFFER_SIZE 65536
#define MAX_BUFFER_COUNT 3
BYTE buffers[MAX_BUFFER_COUNT][STREAMING_BUFFER_SIZE];

OVERLAPPED 構造体を初期化します。

構造体は、非同期ディスクの読み取りが完了したときにチェックするために使用されます。
```
OVERLAPPED Overlapped = {0};
Overlapped.hEvent = CreateEvent( NULL, TRUE, FALSE, NULL );
```
ストリーミングオーディオを再生するソース音声で Start 関数を呼び出します。
```
hr = pSourceVoice->Start( 0, 0 );
```

現在の読み取り位置がオーディオファイルの末尾に渡されない間はループします。

CurrentDiskReadBuffer = 0;
CurrentPosition = 0;
while ( CurrentPosition < cbWaveSize )
{
    ...
}

ループで、次の操作を行います。

ディスクから現在の読み取りバッファーにデータのチャンクを読み取ります。

DWORD dwRead;
if( SUCCEEDED(hr) && 0 == ReadFile( hFile, pData, dwDataSize, &dwRead, pOverlapped ) )
    hr = HRESULT_FROM_WIN32( GetLastError() );
    DWORD cbValid = min( STREAMING_BUFFER_SIZE, cbWaveSize - CurrentPosition );
    DWORD dwRead;
    if( 0 == ReadFile( hFile, buffers[CurrentDiskReadBuffer], STREAMING_BUFFER_SIZE, &dwRead, &Overlapped ) )
        hr = HRESULT_FROM_WIN32( GetLastError() );
    Overlapped.Offset += cbValid;

    //update the file position to where it will be once the read finishes
    CurrentPosition += cbValid;

GetOverlappedResult 関数を使用して、読み取りが完了したことを通知するイベントを待機します。
```
DWORD NumberBytesTransferred;
::GetOverlappedResult(hFile,&Overlapped,&NumberBytesTransferred, TRUE);
```
ソース音声でキューに登録されているバッファーの数が読み取りバッファーの数より少なくなるのを待ちます。

ソース音声の状態は、GetState 関数で確認されます。
```
XAUDIO2_VOICE_STATE state;
while( pSourceVoice->GetState( &state ), state.BuffersQueued >= MAX_BUFFER_COUNT - 1)
{
    WaitForSingleObject( Context.hBufferEndEvent, INFINITE );
}
```

SubmitSourceBuffer 関数を使用して、現在の読み取りバッファーをソース音声に送信します。

XAUDIO2_BUFFER buf = {0};
buf.AudioBytes = cbValid;
buf.pAudioData = buffers[CurrentDiskReadBuffer];
if( CurrentPosition >= cbWaveSize )
{
    buf.Flags = XAUDIO2_END_OF_STREAM;
}
pSourceVoice->SubmitSourceBuffer( &buf );

現在の読み取りバッファーインデックスを次のバッファーに設定します。
```
CurrentDiskReadBuffer++;
CurrentDiskReadBuffer %= MAX_BUFFER_COUNT;
```

ループが完了したら、残りのキューに入っているバッファーの再生が完了するまで待ちます。

残りのバッファーの再生が完了すると、サウンドが停止し、スレッドが終了するか、別のサウンドをストリーミングするために再利用できます。
```
XAUDIO2_VOICE_STATE state;
while( pSourceVoice->GetState( &state ), state.BuffersQueued > 0 )
{
    WaitForSingleObjectEx( Context.hBufferEndEvent, INFINITE, TRUE );
}
```

コールバッククラスの作成

コールバッククラスを作成するには、 IXAudio2VoiceCallback インターフェイスから継承するクラスを作成します。

クラスは 、OnBufferEnd メソッドでイベントを設定する必要があります。これにより、ストリーミングスレッドは、XAudio2 がオーディオバッファーからの読み取りを完了したことをイベントが通知するまでスリープ状態になります。 XAudio2 でコールバックを使用する方法の詳細については、「方法: ソース音声コールバックを使用する」を参照してください。

struct StreamingVoiceContext : public IXAudio2VoiceCallback
{
    HANDLE hBufferEndEvent;
    StreamingVoiceContext(): hBufferEndEvent( CreateEvent( NULL, FALSE, FALSE, NULL ) ){}
    ~StreamingVoiceContext(){ CloseHandle( hBufferEndEvent ); }
    void OnBufferEnd( void* ){ SetEvent( hBufferEndEvent ); }
    ...
};

オーディオデータのストリーミング
XAudio2 のコールバック
XAudio2 プログラミングガイド
方法: 基本的なオーディオ処理グラフの作成
方法: ソースボイスのコールバックの使用

Share via

方法: ディスクからのサウンドのストリーム

ストリーミングスレッドでのバッファー読み取りの実行

コールバッククラスの作成

フィードバック

フィードバック

その他のリソース

Share via

方法: ディスクからのサウンドのストリーム

ストリーミング スレッドでのバッファー読み取りの実行

コールバック クラスの作成

関連トピック

フィードバック

フィードバック

その他のリソース

ストリーミングスレッドでのバッファー読み取りの実行

コールバッククラスの作成