ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects-Methode (spatialaudioclient.h)

Versetzt das System in den Zustand, in dem Audioobjektdaten zur Verarbeitung übermittelt und der ISpatialAudioObject-Zustand geändert werden kann.

Syntax

HRESULT BeginUpdatingAudioObjects(
  [out] UINT32 *availableDynamicObjectCount,
  [out] UINT32 *frameCountPerBuffer
);

Parameter

[out] availableDynamicObjectCount

Die Anzahl der dynamischen Audioobjekte, die für den aktuellen Verarbeitungsdurchlauf gerendert werden können. Alle zugeordneten statischen Audioobjekte können in jedem Durchlauf gerendert werden. Informationen zu Audioobjekttypen finden Sie unter AudioObjectType.

[out] frameCountPerBuffer

Die Größe des von GetBuffer zurückgegebenen Puffers in Audioframes.

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	BeginUpdatingAudioObjects wurde zweimal ohne einen entsprechenden Aufruf von EndUpdatingAudioObjects zwischen den beiden Aufrufen aufgerufen.
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.
AUDCLNT_E_RESOURCES_INVALIDATED	Eine Ressource, die dem räumlichen Audiostream zugeordnet ist, ist nicht mehr gültig.
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

Diese Methode muss jedes Mal aufgerufen werden, wenn das ereignis, das in SpatialAudioObjectRenderStreamActivationParams an ISpatialAudioClient::ActivateSpatialAudioStream übergeben wird, signalisiert wird.
auch dann, wenn keine Audioobjektdaten zum Übermitteln vorhanden sind.

Für jeden BeginUpdatingAudioObjects-Aufruf sollte ein entsprechender Aufruf des EndUpdatingAudioObjects-Aufrufs vorhanden sein.
Wenn BeginUpdatingAudioObjects zweimal aufgerufen wird, ohne dass endUpdatingAudioObjects zwischen ihnen aufgerufen wird, wird der zweite Aufruf von
BeginUpdatingAudioObjects gibt SPTLAUDCLNT_E_OUT_OF_ORDER zurück.

Anforderungen

Zielplattform	Windows
Kopfzeile	spatialaudioclient.h

Weitere Informationen

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase