Edit

DXCoreAdapterMemoryBudget structure (dxcore_interface.h)

  • Article

Describes the memory budget for an adapter.

Syntax

struct DXCoreAdapterMemoryBudget {
  uint64_t budget;
  uint64_t currentUsage;
  uint64_t availableForReservation;
  uint64_t currentReservation;
};

Members

budget

Type: uint64_t

Specifies the OS-provided adapter memory budget, in bytes, that your application should target. If currentUsage is greater than budget, then your application may incur stuttering or performance penalties due to background activity by the OS, which is intended to provide other applications with a fair usage of adapter memory.

currentUsage

Type: uint64_t

Specifies your application's current adapter memory usage, in bytes.

availableForReservation

Type: uint64_t

Specifies the amount of adapter memory, in bytes, that your application has available for reservation. To reserve this adapter memory, your application should call IDXCoreAdapter::SetState with state set to DXCoreAdapterState::AdapterMemoryBudget.

currentReservation

Type: uint64_t

Specifies the amount of adapter memory, in bytes, that is reserved by your application. The OS uses the reservation as a hint to determine your application's minimum working set. Your application should attempt to ensure that its adapter memory usage can be trimmed to meet this requirement.

Requirements

Requirement Value
Minimum supported client Windows 10 (Build 18936)
Header dxcore_interface.h (include dxcore.h)

See also

DXCore Reference, Using DXCore to enumerate adapters