ISpatialAudioObjectForHrtf::SetEnvironment-Methode (spatialaudiohrtf.h)

Legt den Typ der akustischen Umgebung fest, die bei der Verarbeitung von Audiodaten für ISpatialAudioObjectForHrtf simuliert wird.

Syntax

HRESULT SetEnvironment(
  [in] SpatialAudioHrtfEnvironmentType environment
);

Parameter

[in] environment

Ein Wert, der den Typ der akustischen Umgebung angibt, die bei der Verarbeitung von Audiodaten für ISpatialAudioObjectForHrtf simuliert wird.

Rückgabewert

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

Rückgabecode Beschreibung
SPTLAUDCLNT_E_OUT_OF_ORDER

ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects wurde vor dem Aufruf von SetEnvironment nicht aufgerufen.

SPTLAUDCLNT_E_RESOURCES_INVALIDATED

SetEndOfStream wurde in einem vorherigen Audioverarbeitungsdurchlauf explizit oder implizit aufgerufen. SetEndOfStream wird implizit vom System aufgerufen, wenn GetBuffer nicht innerhalb eines Audioverarbeitungsdurchlaufs aufgerufen wird (zwischen Aufrufen von ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects und ISpatialAudioObjectRenderStreamBase:EndUpdatingAudioObjects).

Hinweise

Wenn SetEnvironment nicht aufgerufen wird, wird der Standardwert von SpatialAudioHrtfEnvironment_Small verwendet.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile spatialaudiohrtf.h

Weitere Informationen

ISpatialAudioObjectForHrtf