ISpatialAudioObjectBase::IsActive-Methode (spatialaudioclient.h)

  • Artikel

Ruft einen booleschen Wert ab, der angibt, ob das ISpatialAudioObject gültig ist.

Syntax

HRESULT IsActive(
  [out] BOOL *isActive
);

Parameter

[out] isActive

TRUE , wenn das Audioobjekt derzeit gültig ist; andernfalls FALSE.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben.

Hinweise

Wenn dieser Wert false ist, sollten Sie Release aufrufen, um die Audioobjektressource in Zukunft verfügbar zu machen.

IsActive wird auf false festgelegt, nachdem SetEndOfStream implizit oder explizit aufgerufen wurde. SetEndOfStream wird implizit vom System aufgerufen, wenn GetBuffer nicht innerhalb eines Audioverarbeitungsdurchlaufs (zwischen Aufrufen von ISpatialAudioObjectRenderStream::BeginUpdatingAudioObjects und ISpatialAudioObjectRenderStream::EndUpdatingAudioObjects) aufgerufen wird.

Die Rendering-Engine deaktiviert auch das Audioobjekt und legt IsActive auf false fest, wenn Audioobjektressourcen nicht mehr verfügbar sind. In diesem Fall wird eine Benachrichtigung über ISpatialAudioObjectRenderStreamNotify gesendet, bevor das Objekt deaktiviert wird. Der Wert, der im parameter availableDynamicObjectCount für ISpatialAudioObjectRenderStream::BeginUpdatingAudioObjects zurückgegeben wird, gibt an, wie viele Objekte für jeden Durchlauf verarbeitet werden.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile spatialaudioclient.h

Weitere Informationen

ISpatialAudioObject

ISpatialAudioObjectBase