ISpatialAudioClient2

ISpatialAudioClient2 インターフェイスは ISpatialAudioClient を継承し、大容量オーディオバッファーのオフロードのサポートを照会するメソッドを追加します。

オーディオオフロードを使用すると、アプリはオーディオデバイスドライバーに大容量のオーディオバッファー(通常は 1～2 秒分)を送信できます。オフロードを使用しない場合、一般的なオーディオバッファーには 10ms 分のデータしか含まれないため、追加のオーディオデータを供給するためにアプリは 1 秒あたり約 100 回起床する必要があります。オフロードされた大容量バッファーを使用すると、特に画面をオフにした状態でユーザーがオーディオを聴取するシナリオにおいて、バッテリーを節約できます。

この機能を使用するには、オーディオデバイスのドライバーがオフロードをサポートしている必要があります。サポートの有無は IsOffloadCapable を呼び出して照会します。オフロードでサポートされるオーディオフレームの最大数は GetMaxFrameCountForCategory を呼び出して確認します。

ISpatialAudioClient2 は Windows 11(Windows ビルド 22000)で導入されたため、このインターフェイスを含まない古いバージョンの Windows 上で実行される場合に対応できるようにコードを記述する必要があります。次の例は、ISpatialAudioClient に対して QueryInterface を呼び出して ISpatialAudioClient2 のインスタンスの取得を試み、取得したインターフェイスが null でないことを確認してからそのメソッドを呼び出す方法を示しています。

HRESULT hr;
Microsoft::WRL::ComPtr<IMMDeviceEnumerator> deviceEnum;
Microsoft::WRL::ComPtr<IMMDevice> defaultDevice;

hr = CoCreateInstance(__uuidof(MMDeviceEnumerator), nullptr, CLSCTX_ALL, __uuidof(IMMDeviceEnumerator), (void**)&deviceEnum);
hr = deviceEnum->GetDefaultAudioEndpoint(EDataFlow::eRender, eMultimedia, &defaultDevice);

Microsoft::WRL::ComPtr<ISpatialAudioClient> spatialAudioClient;
hr = defaultDevice->Activate(__uuidof(ISpatialAudioClient), CLSCTX_INPROC_SERVER, nullptr, (void**)&spatialAudioClient);

Microsoft::WRL::ComPtr<ISpatialAudioClient2> spatialAudioClient2;
hr = spatialAudioClient->QueryInterface(__uuidof(ISpatialAudioClient2), (void**)&spatialAudioClient2);

if (spatialAudioClient2 != nullptr)
{
    BOOL offloadCapable = false;

    // AudioCategory_Media is just for example purposes.
    // Specify the same audio category that you intend specify in the call toISpatialAudioClient::ActivateSpatialAudioStream
    hr = spatialAudioClient2->IsOffloadCapable(AudioCategory_Media, &offloadCapable);
}

IMMDevice にアクセスできない UWP アプリの場合は、ActivateAudioInterfaceAsync を呼び出して ISpatialAudioClient のインスタンスを取得する必要があります。例については、WindowsAudioSession サンプルを参照してください。

ISpatialAudioClient2 が作成されたオーディオレンダリングエンドポイントが、ハードウェアオフロードによるオーディオ処理をサポートしているかどうかを照会します。

次の値を含む HRESULT。

処理パスあたりでサポートされる最大フレーム数を取得します。

次の値を含む HRESULT。

このメソッドが返す値は、ソースバッファーの割り当てに使用できます。この値はエンドポイントのケイデンスが変化すると変わります。呼び出し側は、ストリームの作成時に使用するのと同じ AUDIO_STREAM_CATEGORY 値および WAVEFORMATEX 値を指定する必要があります。ストリームを SPATIAL_AUDIO_STREAM_OPTIONS_OFFLOAD フラグを指定して作成する場合は、offloadEnabled パラメーターを TRUE に設定する必要があります。