ISpatialAudioObjectBase::IsActive-Methode (spatialaudioclient.h)
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 |