ISpatialAudioObjectBase::IsActive 方法 (spatialaudioclient.h)
获取一个布尔值,该值指示 ISpatialAudioObject 是否有效。
语法
HRESULT IsActive(
[out] BOOL *isActive
);
参数
[out] isActive
如果音频对象当前有效,则为 TRUE;否则为 FALSE。
返回值
如果该方法成功,则它会返回 S_OK。
注解
如果此值为 false,则应调用 Release 以使音频对象资源在将来可用。
以隐式或显式方式调用 SetEndOfStream 后,IsActive 将设置为 false。 如果未在音频处理中调用 GetBuffer,则系统将隐式调用 SetEndOfStream, (在调用 ISpatialAudioObjectRenderStream::BeginUpdatingAudioObjects 和 ISpatialAudioObjectRenderStream::EndUpdatingAudioObjects) 。
当音频对象资源不可用时,呈现引擎还将停用音频对象,并将 IsActive 设置为 false。 在这种情况下,在停用对象之前,将通过 ISpatialAudioObjectRenderStreamNotify 发送通知。 在 availableDynamicObjectCount 参数中返回到 ISpatialAudioObjectRenderStream::BeginUpdatingAudioObjects 的值指示将为每个传递处理多少个对象。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | spatialaudioclient.h |