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 를 통해 알림이 전송됩니다. ISpatialAudioObjectRenderStream::BeginUpdatingAudioObjects에 대한 availableDynamicObjectCount 매개 변수에 반환된 값은 각 패스에 대해 처리될 개체 수를 나타냅니다.

요구 사항

추가 정보

ISpatialAudioObject

ISpatialAudioObjectBase