Edit

Share via

D3DKMT_RECLAIMALLOCATIONS2 structure (d3dkmthk.h)

  • Article

D3DKMT_RECLAIMALLOCATIONS2 describes video memory resources that are to be reclaimed and that the driver previously offered for reuse. Used with the D3DKMTReclaimAllocations2 function.

Syntax

typedef struct _D3DKMT_RECLAIMALLOCATIONS2 {
  [in]  D3DKMT_HANDLE         hPagingQueue;
  [in]  UINT                  NumAllocations;
  [in]  D3DKMT_HANDLE         *pResources;
  [in]  const D3DKMT_HANDLE   *HandleList;
  union {
    [out] BOOL                  *pDiscarded;
    [in]  D3DDDI_RECLAIM_RESULT *pResults;
  };
  [out] BOOL                  *pDiscarded;
        D3DKMT_ALIGN64 UINT64 PagingFenceValue;
} D3DKMT_RECLAIMALLOCATIONS2;

Members

[in] hPagingQueue

A handle to the device that created the allocations.

[in] NumAllocations

The number of items in the pResources, HandleList, or pDiscarded members, whichever is not NULL.

[in] pResources

An array of D3DKMT_HANDLE data types that represent Direct3D runtime resource handles.

[in] HandleList

An array of D3DKMT_HANDLE data types that represent kernel-mode handles to the allocations that are to be reclaimed.

If HandleList is not NULL, the pResources member must be NULL.

[out] pDiscarded

Optional array of boolean variables specifying whether each resource or allocation was discarded.

pResults

[out] Pointer to an array of D3DDDI_RECLAIM_RESULT enumerations that represent results, specifying whether each resource or allocation is OK, discarded, or has no commitment.

pResults is valid only if the DXGKDDI_INTERFACE_VERSION and D3D_UMD_INTERFACE_VERSION are greater than or equal to DXGKDDI_INTERFACE_VERSION_WDDM2_1 and D3D_UMD_INTERFACE_VERSION_WDDM2_1, respectively.

[in] pResults

Required array of values specifying whether the surface is valid, discarded, or list commitment.

PagingFenceValue

The paging fence to synchronize against before submitting work to the GPU which references any of the resources or allocations in the provided arrays.

Requirements

Requirement Value
Minimum supported client Windows 10
Minimum supported server Windows Server 2016
Header d3dkmthk.h (include D3dkmthk.h)