#include <DeviceResource.h>

Inherited by AZ::RHI::DeviceBuffer, AZ::RHI::DeviceImage, AZ::RHI::DeviceQuery, and AZ::RHI::DeviceShaderResourceGroup.

Public Member Functions
	AZ_RTTI (DeviceResource, "{9D02CDAC-80EB-4B77-8E62-849AC6E69206}", DeviceObject)

bool	IsAttachment () const
	Returns whether the resource is currently an attachment on a frame graph.

void	Shutdown () override final
	Shuts down the buffer by detaching it from its parent pool.

const DeviceResourcePool *	GetPool () const

DeviceResourcePool *	GetPool ()

uint32_t	GetVersion () const

virtual void	ReportMemoryUsage (MemoryStatisticsBuilder &builder) const =0
	Reports memory usage of this image to the memory statistics builder.

const FrameAttachment *	GetFrameAttachment () const
	Returns the frame attachment associated with this image (if it exists).

void	InvalidateViews ()

bool	IsInResourceCache (const ImageViewDescriptor &imageViewDescriptor)
	Returns true if the DeviceResourceView is in the cache.

bool	IsInResourceCache (const BufferViewDescriptor &bufferViewDescriptor)

void	EraseResourceView (DeviceResourceView *resourceView) const
	Removes the provided DeviceResourceView from the cache.

Public Member Functions inherited from AZ::RHI::DeviceObject
	AZ_RTTI (DeviceObject, "{17D34F71-944C-4AF5-9823-627474C4C0A6}", Object)

bool	IsInitialized () const
	Returns whether the device object is initialized.

Device &	GetDevice () const

Public Member Functions inherited from AZ::RHI::Object
	AZ_RTTI (Object, "{E43378F1-2331-4173-94B8-990ED20E6003}")

void	SetName (const Name &name)
	Sets the name of the object.

const Name &	GetName () const
	Returns the name set on the object by SetName.

uint32_t	use_count ()
	Returns the current use count of the object.

Protected Member Functions
Ptr< DeviceImageView >	GetResourceView (const ImageViewDescriptor &imageViewDescriptor) const
	Returns view based on the descriptor.

Ptr< DeviceBufferView >	GetResourceView (const BufferViewDescriptor &bufferViewDescriptor) const

Protected Member Functions inherited from AZ::RHI::DeviceObject
void	Init (Device &device)
	The derived class should call this method to assign the device.

Protected Member Functions inherited from AZ::RHI::Object
void	add_ref () const

void	release () const

Friends
class	Resource

class	ResourceView

class	DeviceResourcePool

Additional Inherited Members
Protected Attributes inherited from AZ::RHI::Object
AZStd::atomic_int	m_useCount = 0

Detailed Description

DeviceResource is a base class for pooled RHI resources (DeviceImage / DeviceBuffer / DeviceShaderResourceGroup, etc). It provides some common lifecycle management semantics. DeviceResource creation is separate from initialization. Resources are created separate from any pool, but its backing platform data is associated at initialization time on a specific pool.

Member Function Documentation

◆ GetPool()

const DeviceResourcePool * AZ::RHI::DeviceResource::GetPool ( ) const

Returns the parent pool this resource is registered on. Since resource creation is separate from initialization, this will be null until the resource is registered on a pool.

◆ GetVersion()

uint32_t AZ::RHI::DeviceResource::GetVersion ( ) const

Returns the version number. This number is monotonically increased anytime new platform memory is assigned to the resource. Any dependent resource is valid so long as the version numbers match.

◆ InvalidateViews()

void AZ::RHI::DeviceResource::InvalidateViews ( )

Invalidates all views referencing this resource. Invalidation is handled implicitly on a Shutdown / Init cycle from the pool. For example, it is safe to create a resource, create a view to that resource, and then Shutdown / Re-Init the resource. InvalidateViews is called to synchronize views (and shader resource groups which hold them) to the new data.

Platform back-ends which invalidate GPU-specific data on the resource without an explicit shutdown / re-initialization will need to call this method explicitly.

◆ ReportMemoryUsage()

virtual void AZ::RHI::DeviceResource::ReportMemoryUsage ( MemoryStatisticsBuilder & builder ) const

pure virtual

Reports memory usage of this image to the memory statistics builder.

Implemented in AZ::RHI::DeviceBuffer, AZ::RHI::DeviceImage, AZ::RHI::DeviceQuery, and AZ::RHI::DeviceShaderResourceGroup.

◆ Shutdown()

void AZ::RHI::DeviceResource::Shutdown ( )

finaloverridevirtual

Shuts down the buffer by detaching it from its parent pool.

Reimplemented from AZ::RHI::DeviceObject.

The documentation for this class was generated from the following file:

Gems/Atom/RHI/Code/Include/Atom/RHI/DeviceResource.h

Public Member Functions

Protected Member Functions

Friends