ISpatialAudioObjectRenderStreamForMetadata::ActivateSpatialAudioObjectForMetadataCommands-Methode (spatialaudiometadata.h)

Artikel
03/02/2024

Aktivieren Eines ISpatialAudioObjectForMetadataCommands zum Rendern .

Syntax

HRESULT ActivateSpatialAudioObjectForMetadataCommands(
  [in]  AudioObjectType                        type,
  [out] ISpatialAudioObjectForMetadataCommands **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	Die maximale Anzahl gleichzeitiger räumlicher Audioobjekte wurde überschritten. Rufen Sie Release für nicht verwendete Audioobjekte auf, bevor Sie versuchen, zusätzliche Objekte zu aktivieren.
SPTLAUDCLNT_E_STATIC_OBJECT_NOT_AVAILABLE	Der im Typparameter angegebene statische Kanal war nicht im Feld StaticObjectTypeMask des SpatialAudioObjectRenderStreamForMetadataActivationParams enthalten, das an ISpatialAudioClient::ActivateSpatialAudioStream übergeben wurde.
SPTLAUDCLNT_E_OBJECT_ALREADY_ACTIVE	Für den im Typparameter angegebenen statischen Kanal wurde bereits ein räumliches Audioobjekt aktiviert.
E_POINTER	Der angegebene Zeiger ist ungültig.
E_INVALIDARG	Der im type-Parameter angegebene Wert ist keiner der Werte, die durch die AudioObjectType-Enumeration definiert werden.
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 ISpatialAudioObjectForMetadataCommands wurde aktiviert, indem der type-Parameter auf die ActivateSpatialAudioObjectForMetadataCommands-Methode auf 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 ISpatialAudioObjectForMetadataCommands auf, nachdem es nicht mehr verwendet wird, um die Ressource freizugeben, damit sie neu zugeordnet werden kann. Weitere Informationen zur Verwaltung der Lebensdauer räumlicher Audioobjekte finden Sie unter ISpatialAudioObjectBase::SetEndOfStream.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	spatialaudiometadata.h

Weitere Informationen

ISpatialAudioObjectForMetadataItems

Share via