ISpatialAudioObjectRenderStreamForHrtf::ActivateSpatialAudioObjectForHrtf-Methode (spatialaudiohrtf.h)

  • Artikel

Aktiviert ein ISpatialAudioObjectForHrtf für das Audiorendering.

Syntax

HRESULT ActivateSpatialAudioObjectForHrtf(
  [in]  AudioObjectType            type,
  [out] ISpatialAudioObjectForHrtf **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 ISpatialAudioObjectForHrtf-Objekt wurde aktiviert, indem der type-Parameter auf die ActivateSpatialAudioObjectForHrtf-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 ISpatialAudioObjectForHrtf 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 ISpatialAudioObjectgBase::SetEndOfStream.

Anforderungen

   
Zielplattform Windows
Kopfzeile spatialaudiohrtf.h

Weitere Informationen

ISpatialAudioRenderStreamForHrtf