ISpatialAudioObjectForHrtf::SetDirectivity-Methode (spatialaudiohrtf.h)

Legt das räumliche Audiodirektivitätsmodell für ISpatialAudioObjectForHrtf fest.

Syntax

HRESULT SetDirectivity(
  SpatialAudioHrtfDirectivityUnion *directivity
);

Parameter

directivity

Das Räumliche Audio-Richtivitätsmodell. Dieser Wert kann eine der folgenden Strukturen sein:

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_OUT_OF_ORDER

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

SPTLAUDCLNT_E_RESOURCES_INVALIDATED

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

Hinweise

Die SpatialAudioHrtfDirectivity-Struktur stellt ein omnidirektionales Modell dar, das linear mit einem Nieren- oder Kegelmodell interpoliert werden kann.

Wenn SetDirectivity nicht aufgerufen wird, wird der Standardtyp von SpatialAudioHrtfDirectivity_OmniDirectional ohne Interpolation verwendet.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile spatialaudiohrtf.h

Weitere Informationen

ISpatialAudioObjectForHrtf