ISpatialAudioClient::ActivateSpatialAudioStream メソッド (spatialaudioclient.h)

空間オーディオ ストリームのアクティブ化構造のいずれかを使用して、空間オーディオ ストリームをアクティブ化および初期化します。

構文

HRESULT ActivateSpatialAudioStream(
  [in]  const PROPVARIANT *activationParams,
  [in]  REFIID            riid,
  [out] void              **stream
);

パラメーター

[in] activationParams

空間オーディオ ストリームのアクティブ化パラメーターを定義する構造体。 vt フィールドは VT_BLOB に設定し、BLOB フィールドには SpatialAudioObjectRenderStreamActivationParams または SpatialAudioObjectRenderStreamForMetadataActivationParams を設定する必要があります。

[in] riid

アクティブにする空間オーディオ ストリーム インターフェイスの UUID。

[out] stream

アクティブ化された空間オーディオ インターフェイスを受け取るポインターへのポインター。

戻り値

メソッドが成功した場合は、S_OK を返します。

解説

このメソッドは、次の空間オーディオ ストリーム インターフェイスのアクティブ化をサポートしています。

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamForMetadata

例

Microsoft::WRL::ComPtr<ISpatialAudioClient> spatialAudioClient;

// Activate ISpatialAudioClient on the desired audio-device 
hr = defaultDevice->Activate(__uuidof(ISpatialAudioClient), CLSCTX_INPROC_SERVER, nullptr, (void**)&spatialAudioClient);

hr = spatialAudioClient->IsAudioObjectFormatSupported(&format);

// Create the event that will be used to signal the client for more data
HANDLE bufferCompletionEvent = CreateEvent(nullptr, FALSE, FALSE, nullptr);

SpatialAudioObjectRenderStreamActivationParams streamParams;
streamParams.ObjectFormat = &format;
streamParams.StaticObjectTypeMask = ChannelMask_Stereo;
streamParams.MinDynamicObjectCount = 0;
streamParams.MaxDynamicObjectCount = 0;
streamParams.Category = AudioCategory_SoundEffects;
streamParams.EventHandle = bufferCompletionEvent;
streamParams.NotifyObject = nullptr;

PROPVARIANT activationParams;
PropVariantInit(&activationParams);
activationParams.vt = VT_BLOB;
activationParams.blob.cbSize = sizeof(streamParams);
activationParams.blob.pBlobData = reinterpret_cast<BYTE *>(&streamParams);

Microsoft::WRL::ComPtr<ISpatialAudioObjectRenderStream> spatialAudioStream;
hr = spatialAudioClient->ActivateSpatialAudioStream(&activationParams, __uuidof(spatialAudioStream), (void**)&spatialAudioStream);

要件

対象プラットフォーム	Windows
ヘッダー	spatialaudioclient.h

関連項目

ISpatialAudioClient

SpatialAudioObjectRenderStreamActivationParams

SpatialAudioObjectRenderStreamForMetadataActivationParams