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

DXComObject

DxgiObject

DxgiDevice3

Implements

IDisposable

Inherited Members

DxgiObject.DxgiObjectGuid

DxgiObject.SetPrivateDataText(in Guid, string)

DxgiObject.SetPrivateDataText(in Guid, ReadOnlySpan<char>)

DxgiObject.GetPrivateDataText(in Guid)

DxgiObject.GetPrivateDataTextCharCount(in Guid)

DxgiObject.GetPrivateDataTextChars(in Guid, Span<char>)

DxgiObject.GetParent(in Guid)

DXComObject.Handle

DXComObject.Dispose()

DXComObject.AddRef()

DXComObject.Release()

DXComObject.QueryInterface(in Guid)

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: JeremyAnsel.DirectX.Dxgi

Assembly: JeremyAnsel.DirectX.Dxgi.dll

Syntax

[SecurityCritical]
public class DxgiDevice3 : DxgiObject, IDisposable

Constructors

| Edit this page View Source

DxgiDevice3(nint)

Initializes a new instance of the DxgiDevice3 class.

Declaration

public DxgiDevice3(nint comPtr)

Parameters

Type	Name	Description
nint	comPtr

Fields

| Edit this page View Source

DxgiDevice3Guid

The interface GUID.

Declaration

public static readonly Guid DxgiDevice3Guid

Field Value

Type	Description
Guid

Properties

| 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

CreateDeviceFromDevice(DXComObject)

Initializes a new instance of the DxgiDevice3 class.

Declaration

public static DxgiDevice3 CreateDeviceFromDevice(DXComObject device)

Parameters

Type	Name	Description
DXComObject	device	A device interface which implements the `IDxgiDevice3` interface.

Returns

Type	Description
DxgiDevice3

| Edit this page View Source

CreateDeviceFromDevice(nint)

Initializes a new instance of the DxgiDevice3 class.

Declaration

public static DxgiDevice3 CreateDeviceFromDevice(nint device)

Parameters

Type	Name	Description
nint	device	A device interface which implements the `IDxgiDevice3` interface.

Returns

Type	Description
DxgiDevice3

| 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 resource, DxgiOfferResourcePriority priority)

Parameters

Type	Name	Description
DxgiResource3	resource	A `IDXGIResource` interface for the resource to offer.
DxgiOfferResourcePriority	priority	A `DXGI_OFFER_RESOURCE_PRIORITY`-typed value that indicates how valuable data is.

| 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

OfferResources(ReadOnlySpan<DxgiResource3>, DxgiOfferResourcePriority)

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

Declaration

public void OfferResources(ReadOnlySpan<DxgiResource3> resources, DxgiOfferResourcePriority priority)

Parameters

Type	Name	Description
ReadOnlySpan<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 a resource.

Declaration

public DxgiResidency QueryResourceResidency(DxgiResource3 resource)

Parameters

Type	Name	Description
DxgiResource3	resource	An `IDXGIResource` interfaces.

Returns

Type	Description
DxgiResidency	A `DXGI_RESIDENCY` flags. Each element describes the residency status for corresponding element in the `resources` argument array.

| 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

QueryResourceResidency(ReadOnlySpan<DxgiResource3>, Span<DxgiResidency>)

Gets the residency status of an array of resources.

Declaration

public void QueryResourceResidency(ReadOnlySpan<DxgiResource3> resources, Span<DxgiResidency> residencies)

Parameters

Type	Name	Description
ReadOnlySpan<DxgiResource3>	resources	An array of `IDXGIResource` interfaces.
Span<DxgiResidency>	residencies	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 IDXGIDevice3::OfferResources.

Declaration

public bool ReclaimResources(DxgiResource3 resource)

Parameters

Type	Name	Description
DxgiResource3	resource	An `IDXGIResource` interface 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.

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

ReclaimResources(DxgiResource3?[]?)

Restores access to resources that were previously offered by calling IDXGIDevice3::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.

Type

Description

bool[]

| Edit this page View Source

ReclaimResources(ReadOnlySpan<DxgiResource3>, Span<bool>)

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

Declaration

public void ReclaimResources(ReadOnlySpan<DxgiResource3> resources, Span<bool> discarded)

Parameters

Type	Name	Description
ReadOnlySpan<DxgiResource3>	resources	An array of pointers to `IDXGIResource` interfaces for the resources to reclaim.
Span<bool>	discarded	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

IDisposable