D3DDDI_MAKERESIDENT structure

D3DDDI_MAKERESIDENT is used with MakeResident (pfnMakeResidentCb or D3DKMTMakeResident) to instruct the OS to add a resource to the device residency list and increment the residency reference count on this allocation.

Syntax

typedef struct D3DDDI_MAKERESIDENT {
  D3DKMT_HANDLE             hPagingQueue;
  UINT                      NumAllocations;
  const D3DKMT_HANDLE       *AllocationList;
  const UINT                *PriorityList;
  D3DDDI_MAKERESIDENT_FLAGS Flags;
  UINT64                    PagingFenceValue;
  UINT64                    NumBytesToTrim;
} D3DDDI_MAKERESIDENT;

Members

hPagingQueue

[in] Paging queue on the device that created the input allocations. This queue will be used for residency operations.

NumAllocations

[in/out] On input, the number of allocation handles in the AllocationList array and allocation priority values in the PriorityList array. On output, the number of allocations successfully made resident.

AllocationList

[in] An array of NumAllocations allocation handles to make resident. All allocations must be created on the device hPagingQueue is created for.

PriorityList

[in] An array of NumAllocations specifying residency priority for each of the input allocations. This value is currently ignored and may be set to NULL.

Flags

[in] Specifies memory residency behavior as documented in D3DDDI_MAKERESIDENT_FLAGS.

PagingFenceValue

[out] When MakeResident returns E_PENDING, this member indicates the paging queue fence value to wait on.

NumBytesToTrim

[out] When MakeResident returns E_OUTOFMEMORY, this member indicates the number of bytes over budget the application would be if the allocation(s) were made resident.

Requirements

   
Minimum supported client Windows 10
Minimum supported server Windows Server 2016
Header d3dukmdt.h (include D3dumddi.h, D3dkmddi.h)

See Also

D3DDDI_MAKERESIDENT_FLAGS

D3DKMTMakeResident

pfnMakeResidentCb