ISpatialAudioObjectRenderStreamBase：：GetAvailableDynamicObjectCount 方法 (spatialaudioclient.h)

获取当前可用的动态空间音频对象的数量。

语法

HRESULT GetAvailableDynamicObjectCount(
  [out] UINT32 *value
);

参数

[out] value

当前可用的动态空间音频对象数。

返回值

如果该方法成功，则它会返回 S_OK。 如果失败，可能的返回代码包括但不限于下表中显示的值。

注解

动态 ISpatialAudioObject 是通过将 type 参数设置为 ActivateSpatialAudioObject 方法激活 AudioObjectType_Dynamic。 系统具有一次可激活的最大动态空间音频对象数的限制。 当 ISpatialAudioObject 不再用于释放资源以创建新的动态空间音频对象时，请对它调用 Release。

不应在流式处理启动后调用此方法，因为值已由 ISpatialAudioObjectRenderStreamBase：：BeginUpdatingAudioObjects 提供。 只能在流式处理启动之前调用此方法，这在调用 ISpatialAudioObjectRenderStreamBase：：Start 之后发生。

要求

返回代码	说明
SPTLAUDCLNT_E_DESTROYED	与空间音频流关联的 ISpatialAudioClient 已被销毁。
AUDCLNT_E_DEVICE_INVALIDATED	与空间音频流关联的音频设备不再有效。
AUDCLNT_E_DEVICE_INVALIDATED	音频终结点设备已拔出，或者音频硬件或关联的硬件资源已重新配置、禁用、删除或以其他方式不可用。
SPTLAUDCLNT_E_INTERNAL	发生了内部错误。
AUDCLNT_E_UNSUPPORTED_FORMAT	与空间音频流关联的媒体使用不受支持的格式。

目标平台	Windows
标头	spatialaudioclient.h

另请参阅

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase