ISpatialAudioObjectRenderStreamForHrtf::ActivateSpatialAudioObjectForHrtf-Methode (spatialaudiohrtf.h)
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 |
|---|---|
|
Das System hat die maximale Anzahl gleichzeitiger Audioobjekte erreicht. |
|
Der dem räumlichen Audiostream zugeordnete ISpatialAudioClient wurde zerstört. |
|
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. |
|
Ein interner Fehler ist aufgetreten. |
|
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 |