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 |