Diligent::StateObjectsRegistry class

Template class implementing state object registry.

Template parameters
ResourceDescType	- type of the resource description. The type must have operator== and a hash function defined.

Reference
- Public static variables
- Public functions

Remark

The following strategies do not work:

To store raw pointers and remove the object from the registry in the object's destructor. In this case other thread may obtain a reference to the object while it is being deleted. This scenario is possible if one thread has just entered the destructor, but other is executing Find() and entered the protection section.
Strong pointers will cause circular references and result in memory leaks.

Only weak pointers provide thread-safe solution. The object is either atomically destroyed, so that no other thread can obtain a reference to it through weak pointers. Or it is atomically locked, so that strong reference is obtained. In this case no other thread can destroy the object, because there is at least one strong reference now. Note however that removing the object from the registry in the object's destructor may cause a deadlock at the point where Find() locks the weak pointer: if other thread has started dtor, the object will be locked by Diligent::RefCountedObject::Release(). If after that this thread locks the registry first, it will be waiting for the object to unlock in Diligent::RefCntWeakPtr::Lock(), while the dtor thread will be waiting for the registry to unlock.

Public static variables

static int DeletedObjectsToPurge constexpr: Number of outstanding deleted objects to purge the registry.

Public functions

void Add(const ResourceDescType& ObjectDesc, IDeviceObject* pObject): Adds a new object to the registry.
void Find(const ResourceDescType& Desc, IDeviceObject** ppObject): Finds the object in the registry.
void Purge(): Purges outstanding deleted objects from the registry.
void ReportDeletedObject(): Increments the number of outstanding deleted objects. When this number reaches DeletedObjectsToPurge, Purge() will be called.

Function documentation

template<typename ResourceDescType>
void Diligent::StateObjectsRegistry<ResourceDescType>::Add(const ResourceDescType& ObjectDesc, IDeviceObject* pObject)

Adds a new object to the registry.

Parameters
ObjectDesc in	- object description.
pObject in	- pointer to the object.

Besides adding a new object, the function also checks the number of outstanding deleted objects and calls Purge() if the number has reached the threshold value DeletedObjectsToPurge. Creating a state object is assumed to be an expensive operation and should be performed during the initialization. Occasional purge operations should not add significant cost to it.

#include <Graphics/GraphicsEngine/include/StateObjectsRegistry.hpp> template<typename ResourceDescType> Diligent::StateObjectsRegistry class

Contents

Public static variables

Public functions

Function documentation

template<typename ResourceDescType> void Diligent::StateObjectsRegistry<ResourceDescType>::Add(const ResourceDescType& ObjectDesc, IDeviceObject* pObject)

#include <Graphics/GraphicsEngine/include/StateObjectsRegistry.hpp>

template<typename ResourceDescType>
Diligent::StateObjectsRegistry class

template<typename ResourceDescType>
void Diligent::StateObjectsRegistry<ResourceDescType>::Add(const ResourceDescType& ObjectDesc, IDeviceObject* pObject)