D3DDDI_MAKERESIDENT structure (d3dukmdt.h)

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 {
  [in]     D3DKMT_HANDLE             hPagingQueue;
  [in/out] UINT                      NumAllocations;
  void                      D3DKMT_PTR(
    const D3DKMT_HANDLE *unnamedParam1,
    AllocationList      unnamedParam2
  );
  void                      D3DKMT_PTR(
    const UINT   *unnamedParam1,
    PriorityList unnamedParam2
  );
  [in]     D3DDDI_MAKERESIDENT_FLAGS Flags;
  [out]    D3DKMT_ALIGN64 UINT64     PagingFenceValue;
  [out]    D3DKMT_ALIGN64 UINT64     NumBytesToTrim;
} D3DDDI_MAKERESIDENT;

Members

[in] hPagingQueue

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

[in/out] NumAllocations

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.

void D3DKMT_PTR( const D3DKMT_HANDLE *unnamedParam1, AllocationList unnamedParam2)

void D3DKMT_PTR( const UINT *unnamedParam1, PriorityList unnamedParam2)

[in] Flags

Specifies memory residency behavior as documented in D3DDDI_MAKERESIDENT_FLAGS.

[out] PagingFenceValue

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

[out] NumBytesToTrim

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

Requirement	Value
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