PFND3DDDI_OFFERRESOURCES callback function (d3dumddi.h)

Called by the Microsoft Direct3D runtime to request that the user-mode display driver offer video memory resources for reuse.

Syntax

PFND3DDDI_OFFERRESOURCES Pfnd3dddiOfferresources;

HRESULT Pfnd3dddiOfferresources(
  HANDLE hDevice,
  const D3DDDIARG_OFFERRESOURCES *unnamedParam2
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

unnamedParam2

pData [in]

A pointer to a D3DDDIARG_OFFERRESOURCES structure that defines the video memory resources that the driver offers.

Return value

Returns one of the following values.

Return code Description
S_OK The video memory resources were successfully offered.
D3DDDIERR_DEVICEREMOVED The driver detected that the display adapter was removed, so the driver did not complete the operation.
If the driver is not aware of the adapter removal, the driver is not required to return this error code.

Remarks

If the user-mode driver does not have outstanding work queued that references an allocation that it has been asked to offer, then it can offer the allocation immediately or postpone the offer until the next call is made to the Flush or Present functions. However, the driver must always process all batched offer calls that have been submitted through Flush or Present.

If the driver uses the renaming service of the video memory manager, then the driver should offer the last allocation instance.

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_OFFERRESOURCES

D3DDDI_DEVICEFUNCS

Flush

Present

ReclaimResources