PFND3DDDI_OFFERRESOURCES callback function (d3dumddi.h)

Article
02/22/2024

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)