ISpatialAudioObjectRenderStreamBase::GetAvailableDynamicObjectCount メソッド (spatialaudioclient.h)
現在使用できる動的空間オーディオ オブジェクトの数を取得します。
構文
HRESULT GetAvailableDynamicObjectCount(
[out] UINT32 *value
);
パラメーター
[out] value
現在使用できる動的空間オーディオ オブジェクトの数。
戻り値
メソッドが成功した場合は、S_OK を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。
解説
動的 ISpatialAudioObject は、 type パラメーターを ActivateSpatialAudioObject メソッドに設定して AudioObjectType_Dynamicすることでアクティブ化された ISpatialAudioObject です。 システムには、一度にアクティブ化できる動的空間オーディオ オブジェクトの最大数に制限があります。 リソースを解放して新しい動的空間オーディオ オブジェクトを作成するために使用されなくなった場合は、ISpatialAudioObject で Release を呼び出します。
この値は ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects によって既に提供されているため、ストリーミングの開始後にこのメソッドを呼び出さないでください。 このメソッドは、ストリーミングが開始される前にのみ呼び出す必要があります。これは、 ISpatialAudioObjectRenderStreamBase::Start が呼び出された後に発生します。
要件
リターン コード | 説明 |
---|---|
|
空間オーディオ ストリームに関連付けられている ISpatialAudioClient が破棄されました。 |
|
空間オーディオ ストリームに関連付けられているオーディオ デバイスは無効です。 |
|
オーディオ エンドポイント デバイスが取り外されているか、オーディオ ハードウェアまたは関連するハードウェア リソースが再構成、無効、削除、またはその他の方法で使用できなくなります。 |
|
内部エラーが発生しました。 |
|
空間オーディオ ストリームに関連付けられているメディアでは、サポートされていない形式が使用されます。 |
対象プラットフォーム | Windows |
ヘッダー | spatialaudioclient.h |