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;
  [in]     const D3DKMT_HANDLE       *AllocationList;
  [in]     const UINT                *PriorityList;
  [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.

[in] AllocationList

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

[in] PriorityList

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

[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

See also

D3DDDI_MAKERESIDENT_FLAGS

D3DKMTMakeResident

pfnMakeResidentCb