IDXGIAdapter3::QueryVideoMemoryInfo method (dxgi1_4.h)
This method informs the process of the current budget and process usage.
Syntax
HRESULT QueryVideoMemoryInfo(
[in] UINT NodeIndex,
[in] DXGI_MEMORY_SEGMENT_GROUP MemorySegmentGroup,
[out] DXGI_QUERY_VIDEO_MEMORY_INFO *pVideoMemoryInfo
);
Parameters
[in] NodeIndex
Type: UINT
Specifies the device's physical adapter for which the video memory information is queried. 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 queried. 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.
[out] pVideoMemoryInfo
Type: DXGI_QUERY_VIDEO_MEMORY_INFO*
Fills in a DXGI_QUERY_VIDEO_MEMORY_INFO structure with the current values.
Return value
Type: HRESULT
Returns S_OK if successful; an error code otherwise. For a list of error codes, see DXGI_ERROR.
Remarks
Applications must explicitly manage their usage of physical memory explicitly and keep usage within the budget assigned to the application process. Processes that cannot kept their usage within their assigned budgets will likely experience stuttering, as they are intermittently frozen and paged-out to allow other processes to run.
Requirements
Requirement | Value |
---|---|
Target Platform | Windows |
Header | dxgi1_4.h (include DXGI1_3.h) |
Library | Dxgi.lib |
DLL | Dxgi.dll |