D3DDDICB_RECLAIMALLOCATIONS structure (d3dumddi.h)

Describes video memory resources that are to be reclaimed and that the user-mode display driver previously offered for reuse. Used with the pfnReclaimAllocationsCb function.

Syntax

typedef struct _D3DDDICB_RECLAIMALLOCATIONS {
  [in]  const HANDLE        *pResources;
  [in]  const D3DKMT_HANDLE *HandleList;
  [out] BOOL                *pDiscarded;
  [in]  UINT                NumAllocations;
} D3DDDICB_RECLAIMALLOCATIONS;

Members

[in] pResources

A pointer to an array of handles to the resources that are to be reclaimed.

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

Note  If resources were created with the D3D10_DDI_BIND_PRESENT flag value set in pCreateResource->BindFlags, the driver must not use the pResources member to reclaim by resource handles. Instead, the driver must reclaim the resources by using allocation handles specified by HandleList.

 

[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

An array of Boolean values that specify whether each resource or allocation was discarded.

Each Boolean value in this array corresponds to a resource at the same index location in the arrays pointed to by pResources or HandleList.

The DirectX graphics kernel subsystem sets each Boolean value to TRUE if the corresponding resource was discarded, or to FALSE if not.

The value of pDiscarded can be NULL. If the driver sets it to NULL, the content of the resource or allocation can be assumed to be lost. If the driver does not need the content of the resource or allocation, setting pDiscarded to NULL might improve performance.

[in] NumAllocations

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

Requirements

Requirement	Value
Minimum supported client	Windows 8
Minimum supported server	Windows Server 2012
Header	d3dumddi.h (include D3dumddi.h)

See also

CreateResource(D3D11)

D3D10DDIARG_CREATERESOURCE

pfnReclaimAllocationsCb