ISpatialAudioObjectBase：：IsActive 方法 (spatialaudioclient.h)

  • 發行項

取得布爾值，指出 ISpatialAudioObject 是否有效。

語法

HRESULT IsActive(
  [out] BOOL *isActive
);

參數

[out] isActive

如果音訊物件目前有效，則為TRUE;否則為 FALSE。

傳回值

如果方法成功，它會傳回 S_OK。

備註

如果此值為 false，您應該呼叫 Release ，讓音訊對象資源在未來可供使用。

在以隱含或明確方式呼叫 SetEndOfStream 之後，IsActive 會設定為 false。 如果未在音訊 (處理內呼叫 GetBuffer，則會隱含地由系統呼叫 SetEndOfStream：：BeginUpdatingAudioObjectRenderStream：：BeginUpdatingAudioObjects 和 ISpatialAudioObjectRenderStream：：EndUpdatingAudioObjects) 。

當音訊對象資源無法使用時，轉譯引擎也會停用音頻物件，將 IsActive 設定為 false。 在此情況下，會在停用物件之前，透過 ISpatialAudioObjectRenderStreamNotify 傳送通知。 可用DynamicObjectCount 參數中傳回給 ISpatialAudioObjectRenderStream：：BeginUpdatingAudioObjects 的值會指出每個傳遞將處理多少物件。

規格需求

需求 值
目標平台 Windows
標頭 spatialaudioclient.h

另請參閱

ISpatialAudioObject

ISpatialAudioObjectBase