ISpatialAudioClient::GetMaxDynamicObjectCount-Methode (spatialaudioclient.h)

  • Artikel

Ruft die maximale Anzahl dynamischer Audioobjekte für den räumlichen Audioclient ab.

Syntax

HRESULT GetMaxDynamicObjectCount(
  [out] UINT32 *value
);

Parameter

[out] value

Ruft die maximale Anzahl dynamischer Objekte für diesen Client ab.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben.

Hinweise

Ein dynamisches ISpatialAudioObject wurde aktiviert, indem der Type-Parameter auf die ISpatialAudioObjectRenderStream::ActivateSpatialAudioObject-Methode auf AudioObjectType_Dynamic festgelegt wurde. Der Client hat eine Grenze für die maximale Anzahl von dynamischen räumlichen Audioobjekten, die gleichzeitig aktiviert werden können. Wenn sich die Kapazität der Audiorenderingpipeline ändert, passt das System die maximale Anzahl gleichzeitiger dynamischer räumlicher Audioobjekte dynamisch an. Zuvor ruft das System OnAvailableDynamicObjectCountChange auf, um Clients über die Änderung des Ressourcenlimits zu benachrichtigen.

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.

Wenn Windows Sonic nicht verfügbar ist (für instance, bei der Wiedergabe auf eingebetteten Laptop-Stereolautsprechern oder wenn der Benutzer Windows Sonic nicht explizit auf dem Gerät aktiviert hat), ist die Anzahl der verfügbaren dynamischen Objekte, die von GetMaxDynamicObjectCount an eine Anwendung zurückgegeben werden, 0.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile spatialaudioclient.h

Weitere Informationen

ISpatialAudioClient