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