Edit

Share via

IDXGIAdapter3::SetVideoMemoryReservation method (dxgi1_4.h)

  • Article

This method sends the minimum required physical memory for an application, to the OS.

Syntax

HRESULT SetVideoMemoryReservation(
  [in] UINT                      NodeIndex,
  [in] DXGI_MEMORY_SEGMENT_GROUP MemorySegmentGroup,
  [in] UINT64                    Reservation
);

Parameters

[in] NodeIndex

Type: UINT

Specifies the device's physical adapter for which the video memory information is being set. For single-GPU operation, set this to zero. If there are multiple GPU nodes, set this to the index of the node (the device's physical adapter) for which the video memory information is being set. See Multi-adapter systems.

[in] MemorySegmentGroup

Type: DXGI_MEMORY_SEGMENT_GROUP

Specifies a DXGI_MEMORY_SEGMENT_GROUP that identifies the group as local or non-local.

[in] Reservation

Type: UINT64

Specifies a UINT64 that sets the minimum required physical memory, in bytes.

Return value

Type: HRESULT

Returns S_OK if successful; an error code otherwise. For a list of error codes, see DXGI_ERROR.

Remarks

Applications are encouraged to set a video reservation to denote the amount of physical memory they cannot go without. This value helps the OS quickly minimize the impact of large memory pressure situations.

Requirements

Requirement Value
Target Platform Windows
Header dxgi1_4.h (include DXGI1_3.h)
Library Dxgi.lib
DLL Dxgi.dll

See also

IDXGIAdapter3