Blt
Expand Minimize

ReclaimResources routine

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

Syntax


PFND3DDDI_RECLAIMRESOURCES ReclaimResources;

__checkReturn HRESULT APIENTRY* ReclaimResources(
  _In_  HANDLE hDevice,
  _In_  const D3DDDIARG_RECLAIMRESOURCES *pData
)
{ ... }

Parameters

hDevice [in]

A handle to the display device (graphics context).

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 codeDescription
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

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Header

D3dumddi.h (include D3dumddi.h)

See also

D3DDDIARG_RECLAIMRESOURCES
D3DDDI_DEVICEFUNCS
OfferResources
pfnReclaimAllocationsCb
ReclaimResourcesDXGI

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft