Edit

PFND3DDDI_RECLAIMRESOURCES callback function (d3dumddi.h)

  • Article

Called by the Microsoft Direct3D runtime to reclaim video memory resources that it previously offered for reuse.

Syntax

PFND3DDDI_RECLAIMRESOURCES Pfnd3dddiReclaimresources;

HRESULT Pfnd3dddiReclaimresources(
  HANDLE hDevice,
  const D3DDDIARG_RECLAIMRESOURCES *unnamedParam2
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

unnamedParam2

pData [in]

A pointer to a D3DDDIARG_RECLAIMRESOURCES structure that defines the video memory resources to reclaim.

Return value

Returns one of the following values:

Return code Description
S_OK The video memory resources were successfully reclaimed.
This error code is returned if the driver does not need to call the pfnReclaimAllocationsCb function.
E_INVALIDARG An invalid parameter was supplied.
This error code is returned if the driver calls the pfnReclaimAllocationsCb function and that function returns E_INVALIDARG.
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.
This error code is returned if the driver calls the pfnReclaimAllocationsCb function and that function returns D3DDDIERR_DEVICEREMOVED.
Note: If this error code is returned, the driver's calling function (typically the ReclaimResourcesDXGI routine) must return this error code to the Direct3D runtime.

Requirements

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

See also

D3DDDIARG_RECLAIMRESOURCES

D3DDDI_DEVICEFUNCS

OfferResources

ReclaimResourcesDXGI

pfnReclaimAllocationsCb