ISpatialAudioObjectRenderStreamBase::GetAvailableDynamicObjectCount-Methode (spatialaudioclient.h)

  • Artikel

Ruft die Anzahl der derzeit verfügbaren dynamischen räumlichen Audioobjekte ab.

Syntax

HRESULT GetAvailableDynamicObjectCount(
  [out] UINT32 *value
);

Parameter

[out] value

Die Anzahl der derzeit verfügbaren dynamischen räumlichen Audioobjekte.

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.

Hinweise

Ein dynamisches ISpatialAudioObject-Objekt wurde aktiviert, indem der Type-Parameter auf die ActivateSpatialAudioObject-Methodeauf AudioObjectType_Dynamic festgelegt wurde. Das System verfügt über eine Beschränkung der maximalen Anzahl dynamischer räumlicher Audioobjekte, die gleichzeitig aktiviert werden können. Rufen Sie Release für ein ISpatialAudioObject auf, wenn es nicht mehr verwendet wird, um die Ressource freizugeben, um neue dynamische räumliche Audioobjekte zu erstellen.

Sie sollten diese Methode nicht aufrufen, nachdem das Streaming gestartet wurde, da der Wert bereits von ISpatialAudioObjectRenderStreamBase::BeginUpdatingAudioObjects bereitgestellt wird. Diese Methode sollte nur aufgerufen werden, bevor das Streaming gestartet wurde, was nach dem Aufruf von ISpatialAudioObjectRenderStreamBase::Start erfolgt.

Anforderungen

Rückgabecode Beschreibung
SPTLAUDCLNT_E_DESTROYED
 Der dem räumlichen Audiostream zugeordnete ISpatialAudioClient wurde zerstört.
AUDCLNT_E_DEVICE_INVALIDATED
 Das Audiogerät, das dem räumlichen Audiostream zugeordnet ist, ist nicht mehr gültig.
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.
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.
   
Zielplattform Windows
Kopfzeile spatialaudioclient.h

Weitere Informationen

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase