ISpatialAudioObjectRenderStream::ActivateSpatialAudioObject-Methode (spatialaudioclient.h)

Artikel
08/26/2023

Aktiviert ein ISpatialAudioObject für das Audiorendering.

Syntax

HRESULT ActivateSpatialAudioObject(
  [in]  AudioObjectType     type,
  [out] ISpatialAudioObject **audioObject
);

Parameter

[in] type

Der Typ des zu aktivierenden Audioobjekts. Für dynamische Audioobjekte muss dieser Wert AudioObjectType_Dynamic sein. Geben Sie für statische Audioobjekte einen der statischen Audiokanalwerte aus der Enumeration an. Wenn Sie AudioObjectType_None angeben, wird ein Audioobjekt erzeugt, das nicht verräumt ist.

[out] audioObject

Empfängt einen Zeiger auf die aktivierte Schnittstelle.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode	Beschreibung
SPTLAUDCLNT_E_NO_MORE_OBJECTS	Das System hat die maximale Anzahl gleichzeitiger Audioobjekte erreicht.
SPTLAUDCLNT_E_DESTROYED	Der dem räumlichen Audiostream zugeordnete ISpatialAudioClient wurde zerstört.
AUDCLNT_E_DEVICE_INVALIDATED	Das Audioendpunktgerät wurde nicht angeschlossen, oder die Audiohardware oder die zugehörigen Hardwareressourcen wurden neu konfiguriert, deaktiviert, entfernt oder anderweitig nicht mehr verfügbar gemacht.
SPTLAUDCLNT_E_INTERNAL	Ein interner Fehler ist aufgetreten.
AUDCLNT_E_UNSUPPORTED_FORMAT	Die Dem räumlichen Audiostream zugeordneten Medien verwenden ein nicht unterstütztes Format.

Hinweise

Ein dynamisches ISpatialAudioObject-Objekt wurde aktiviert, indem der Type-Parameter auf die ActivateSpatialAudioObject-Methodeauf AudioObjectType_Dynamic festgelegt wurde. Der Client verfügt über eine Beschränkung der maximalen Anzahl dynamischer räumlicher Audioobjekte, die gleichzeitig aktiviert werden können. Nachdem der Grenzwert erreicht wurde, führt der Versuch, zusätzliche Audioobjekte zu aktivieren, dazu, dass diese Methode einen SPTLAUDCLNT_E_NO_MORE_OBJECTS Fehler zurückgibt. Um dies zu vermeiden, rufen Sie Release für jedes dynamische ISpatialAudioObject auf, nachdem es nicht mehr verwendet wird, um die Ressource freizugeben, damit sie neu zugeordnet werden kann. Weitere Informationen zur Verwaltung der Lebensdauer von räumlichen Audioobjekten finden Sie unter ISpatialAudioObject::SetEndOfStream.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	spatialaudioclient.h

Weitere Informationen

ISpatialAudioObjectRenderStream

Freigeben über