Class DxgiDevice3

The IDXGIDevice3 interface implements a derived class for DXGI objects that produce image data. The interface exposes a method to trim graphics memory usage by the DXGI device.

Inheritance
object
DxgiObject
DxgiDevice3
Implements
Inherited Members
Namespace: JeremyAnsel.DirectX.Dxgi
Assembly: JeremyAnsel.DirectX.Dxgi.dll
Syntax
public sealed class DxgiDevice3 : DxgiObject, IDisposable, IDxgiReleasable

Constructors

| Edit this page View Source

DxgiDevice3(object)

Initializes a new instance of the DxgiDevice3 class.

Declaration
public DxgiDevice3(object device)
Parameters
Type Name Description
object device

A device interface which implements the IDxgiDevice3 interface.

Properties

| Edit this page View Source

Handle

Gets an handle representing the DXGI object interface.

Declaration
public override object Handle { get; }
Property Value
Type Description
object
Overrides
| Edit this page View Source

MaximumFrameLatency

Gets or sets the number of frames that the system is allowed to queue for rendering.

Declaration
public uint MaximumFrameLatency { get; set; }
Property Value
Type Description
uint

The number of frames that can be queued for render. This value defaults to 3, but can range from 1 to 16.

Methods

| Edit this page View Source

GetAdapter()

Returns the adapter for the specified device.

Declaration
public DxgiAdapter3 GetAdapter()
Returns
Type Description
DxgiAdapter3

The adapter for the specified device.
| Edit this page View Source

OfferResources(DxgiResource3[], DxgiOfferResourcePriority)

Allows the operating system to free the video memory of resources by discarding their content.

Declaration
public void OfferResources(DxgiResource3[] resources, DxgiOfferResourcePriority priority)
Parameters
Type Name Description
DxgiResource3[] resources

An array of pointers to IDXGIResource interfaces for the resources to offer.
DxgiOfferResourcePriority priority

A DXGI_OFFER_RESOURCE_PRIORITY-typed value that indicates how valuable data is.
| Edit this page View Source

QueryResourceResidency(DxgiResource3[])

Gets the residency status of an array of resources.

Declaration
public DxgiResidency[] QueryResourceResidency(DxgiResource3[] resources)
Parameters
Type Name Description
DxgiResource3[] resources

An array of IDXGIResource interfaces.
Returns
Type Description
DxgiResidency[]

An array of DXGI_RESIDENCY flags. Each element describes the residency status for corresponding element in the resources argument array.
| Edit this page View Source

ReclaimResources(DxgiResource3[])

Restores access to resources that were previously offered by calling IDXGIDevice2::OfferResources.

Declaration
public bool[] ReclaimResources(DxgiResource3[] resources)
Parameters
Type Name Description
DxgiResource3[] resources

An array of pointers to IDXGIResource interfaces for the resources to reclaim.
Returns
Type Description
bool[]

A pointer to an array that receives Boolean values. Each value in the array corresponds to a resource at the same index that the ppResources parameter specifies. The runtime sets each Boolean value to TRUE if the corresponding resource’s content was discarded and is now undefined, or to FALSE if the corresponding resource’s old content is still intact. The caller can pass in NULL, if the caller intends to fill the resources with new content regardless of whether the old content was discarded.
| Edit this page View Source

Trim()

Trims the graphics memory allocated by the IDXGIDevice3 DXGI device on the app's behalf.

Declaration
public void Trim()

Implements