ISpatialAudioObjectRenderStreamBase::GetAvailableDynamicObjectCount-Methode (spatialaudioclient.h)
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 |
|---|---|
|
Der dem räumlichen Audiostream zugeordnete ISpatialAudioClient wurde zerstört. |
|
Das Audiogerät, das dem räumlichen Audiostream zugeordnet ist, ist nicht mehr gültig. |
|
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. |
|
Ein interner Fehler ist aufgetreten. |
|
Die Dem räumlichen Audiostream zugeordneten Medien verwenden ein nicht unterstütztes Format. |
| Zielplattform | Windows |
| Kopfzeile | spatialaudioclient.h |