ISpatialAudioClient::GetMaxDynamicObjectCount method

[Some information relates to pre-released product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.]

Gets the maximum number of dynamic audio objects for the spatial audio client.

Syntax


HRESULT GetMaxDynamicObjectCount(
  [out]  UINT32 *value
);

Parameters

value [out]

Gets the maximum dynamic object count for this client.

Return value

If the method succeeds, it returns S_OK.

Remarks

A dynamic ISpatialAudioObject is one that was activated by setting the type parameter to the ISpatialAudioObjectRenderStream::ActivateSpatialAudioObject method to AudioObjectType_Dynamic. The client has a limit of the maximum number of dynamic spatial audio objects that can be activated at one time. When the capacity of the audio rendering pipeline changes, the system will dynamically adjust the maximum number of concurrent dynamic spatial audio objects. Before doing so, the system will call OnAvailableDynamicObjectCountChange to notify clients of the resource limit change.

Call Release on an ISpatialAudioObject when it is no longer being used to free up the resource to create new dynamic spatial audio objects.

When Windows Sonic is not available (for instance, when playing to embedded laptop stereo speakers, or if the user has not explicitly enabled Windows Sonic on the device), the number of available dynamic objects returned by GetMaxDynamicObjectCount to an application will be 0.

Requirements

Header

Spatialaudioclient.h

See also

ISpatialAudioClient

 

 

Show: