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