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 |