PFND3DDDI_RECLAIMALLOCATIONS3CB callback function (d3dumddi.h)

pfnReclaimAllocations3Cb is called by the user mode driver to reclaim video memory allocations that were previously offered for reuse.

Syntax

PFND3DDDI_RECLAIMALLOCATIONS3CB Pfnd3dddiReclaimallocations3cb;

HRESULT Pfnd3dddiReclaimallocations3cb(
  HANDLE hDevice,
  D3DDDICB_RECLAIMALLOCATIONS3 *unnamedParam2
)
{...}

Parameters

hDevice

A handle to the display device.

unnamedParam2

pData [in, out]

A pointer to a D3DDDICB_RECLAIMALLOCATIONS3 structure that defines the allocations to reclaim. The previously used discarded array is replaced by a pResults member in this iteration.

Return value

Returns one of the following values.

Return code Description
S_OK The allocations were successfully reclaimed.
E_INVALIDARG An invalid parameter was supplied.
D3DDDIERR_DEVICEREMOVED The video memory manager or display miniport driver could not complete the operation because either a Plug and Play (PnP) Stop event or a Timeout Detection and Recovery (TDR) event occurred.
Note: If this error code is returned, the driver's calling function (typically the pfnReclaimResources routine) must return this error code to the Direct3D runtime.

Requirements

Requirement Value
Minimum supported client Windows 10
Minimum supported server Windows Server 2016
Target Platform Desktop
Header d3dumddi.h (include D3dumddi.h)

See also

D3DDDICB_RECLAIMALLOCATIONS3

D3DDDI_DEVICECALLBACKS

pfnReclaimResources