AUDCLNT_STREAMFLAGS_XXX定数

ストリームの初期化中にクライアントがオーディオ ストリームに割り当てることができる特性を指定します。

解説

IAudioClient::Initialize メソッドとDIRECTX_AUDIO_ACTIVATION_PARAMS構造体は、AUDCLNT_STREAMFLAGS_XXX定数を使用します。

AUDCLNT_STREAMFLAGS_CROSSPROCESS フラグは、ストリームのオーディオ セッションがクロスプロセス セッションであることを示します。 クロスプロセス セッションでは、複数のプロセスからのストリームを受け入れることがあります。 2 つの異なるプロセスの 2 つのアプリケーションが同じセッション GUID で IAudioClient::Initialize を呼び出し、両方のアプリケーションで AUDCLNT_SHAREMODE_CROSSPROCESS フラグを設定した場合、オーディオ エンジンはストリームを同じクロスプロセス セッションに割り当てます。 このフラグは、クロスプロセス セッションではなく、プロセス固有のセッションにストリームを割り当てる既定の動作をオーバーライドします。 AUDCLNT_STREAMFLAGS_CROSSPROCESS フラグ ビットは排他モードと互換性がありません。 クロスプロセス セッションの詳細については、「 オーディオ セッション」を参照してください。

AUDCLNT_STREAMFLAGS_LOOPBACK フラグを使用すると、ループバック記録が有効になります。 ループバック記録では、オーディオ エンジンは、レンダリング エンドポイント デバイスによって再生されているオーディオ ストリームをオーディオ エンドポイント バッファーにコピーして、 WASAPI クライアントがストリームをキャプチャできるようにします。 このフラグが設定されている場合、 IAudioClient::Initialize メソッドはレンダリング デバイスでキャプチャ バッファーを開こうとします。 このフラグは、レンダリング デバイスに対してのみ有効であり、 Initialize 呼び出しによって ShareMode パラメーターがAUDCLNT_SHAREMODE_SHAREDに設定されている場合にのみ有効です。 それ以外の場合、 Initialize 呼び出しは失敗します。 呼び出しが成功した場合、クライアントは IAudioClient::GetService メソッドを呼び出して、レンダリング デバイス上の IAudioCaptureClient インターフェイスを取得できます。 詳細については、「 ループバック記録」を参照してください。

AUDCLNT_STREAMFLAGS_EVENTCALLBACK フラグを使用すると、イベント ドリブン バッファリングが有効になります。 クライアントがストリームを初期化する IAudioClient::Initialize の呼び出しでこのフラグを設定する場合、クライアントは後で IAudioClient::SetEventHandle メソッドを呼び出してストリームのイベント ハンドルを指定する必要があります。 ストリームの開始後、オーディオ エンジンは、バッファーがクライアントが処理する準備が整うたびにクライアントに通知するようにイベント ハンドルに通知します。 WASAPI では、レンダリング バッファーとキャプチャ バッファーの両方に対してイベント ドリブン バッファリングがサポートされています。 共有モード ストリームと排他モード ストリームの両方で、イベント ドリブン バッファリングを使用できます。 AUDCLNT_STREAMFLAGS_EVENTCALLBACK フラグを使用するコード例については、「 排他モード ストリーム」を参照してください。

AUDCLNT_STREAMFLAGS_NOPERSIST フラグは、レンダリング ストリームを含むセッションのボリュームとミュート設定の永続化を無効にします。 既定では、レンダリング セッションのボリューム レベルとミュート状態は、アプリケーションの再起動間で永続的です。 キャプチャ セッションのボリューム レベルとミュート状態は永続的ではありません。 セッション ボリュームとミュート設定の永続化の詳細については、「 オーディオ セッション」を参照してください。

AUDCLNT_STREAMFLAGS_RATEADJUST フラグを使用すると、アプリケーションは、ストリームのサンプル レートを設定するために使用される IAudioClockAdjustment インターフェイスへの参照を取得できます。 このインターフェイスへのポインターを取得するには、アプリケーションでこのフラグを使用してオーディオ クライアントを初期化し、IID_IAudioClockAdjustment識別子を指定して IAudioClient::GetService を呼び出す必要があります。 新しいサンプル レートを設定するには、 IAudioClockAdjustment::SetSampleRate を呼び出します。 このフラグは、レンダリング デバイスに対してのみ有効です。 それ以外の場合、 GetService 呼び出しはエラー コード AUDCLNT_E_WRONG_ENDPOINT_TYPEで失敗します。 また、アプリケーションでは、Initialize 呼び出し中に ShareMode パラメーターを AUDCLNT_SHAREMODE_SHARED に設定する必要があります。 オーディオ クライアントが共有モードでない場合、SetSampleRate は失敗します。

必要条件

関連項目

コア オーディオ定数

IAudioCaptureClient インターフェイス

IAudioClient::GetService

IAudioClient::Initialize

IAudioClient::SetEventHandle