ISpatialAudioObjectRenderStream::ActivateSpatialAudioObject メソッド (spatialaudioclient.h)
オーディオ レンダリング用に ISpatialAudioObject をアクティブにします。
構文
HRESULT ActivateSpatialAudioObject(
[in] AudioObjectType type,
[out] ISpatialAudioObject **audioObject
);
パラメーター
[in] type
アクティブにするオーディオ オブジェクトの種類。 動的オーディオ オブジェクトの場合、この値は AudioObjectType_Dynamicする必要があります。 静的オーディオ オブジェクトの場合は、列挙体の静的オーディオ チャネル値のいずれかを指定します。 AudioObjectType_Noneを指定すると、空間化されていないオーディオ オブジェクトが生成されます。
[out] audioObject
アクティブ化されたインターフェイスへのポインターを受け取ります。
戻り値
メソッドが成功した場合は、S_OK を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。
リターン コード | 説明 |
---|---|
|
システムは、同時オーディオ オブジェクトの最大数に達しました。 |
|
空間オーディオ ストリームに関連付けられている ISpatialAudioClient が破棄されました。 |
|
オーディオ エンドポイント デバイスが取り外されているか、オーディオ ハードウェアまたは関連するハードウェア リソースが再構成、無効、削除、またはその他の方法で使用できなくなります。 |
|
内部エラーが発生しました。 |
|
空間オーディオ ストリームに関連付けられているメディアでは、サポートされていない形式が使用されます。 |
注釈
動的 ISpatialAudioObject は、 type パラメーターを ActivateSpatialAudioObject メソッドに設定して AudioObjectType_Dynamicすることでアクティブ化された ISpatialAudioObject です。 クライアントには、一度にアクティブ化できる動的空間オーディオ オブジェクトの最大数の制限があります。 制限に達すると、追加のオーディオ オブジェクトをアクティブ化しようとすると、このメソッドから SPTLAUDCLNT_E_NO_MORE_OBJECTS エラーが返されます。 これを回避するには、リソースを解放して再割り当てできるようにリソースを解放するために使用されなくなった後、各動的 ISpatialAudioObject に対して Release を呼び出します。 空間オーディオ オブジェクトの有効期間の管理の詳細については、「 ISpatialAudioObject::IsActive 」および「 ISpatialAudioObject::SetEndOfStream 」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | spatialaudioclient.h |