Edit

PDD_GETAVAILDRIVERMEMORY callback function (ddrawint.h)

  • Article

The DdGetAvailDriverMemory callback function queries the amount of free memory in the driver-managed memory heap.

Syntax

PDD_GETAVAILDRIVERMEMORY PddGetavaildrivermemory;

DWORD PddGetavaildrivermemory(
  PDD_GETAVAILDRIVERMEMORYDATA unnamedParam1
)
{...}

Parameters

unnamedParam1

Points to a DD_GETAVAILDRIVERMEMORYDATA structure that contains the information required to perform the query.

Return value

DdGetAvailDriverMemory returns one of the following callback codes:

Remarks

This function does not need to be implemented if the memory will be managed by DirectDraw.

DdGetAvailDriverMemory determines how much free memory is in the driver's private heaps for the specified surface type. The driver should check the surface capabilities specified in the DDSCaps member of the following structure against the heaps it is maintaining internally, to determine what heap size to query. For example, if DDSCAPS_NONLOCALVIDMEM is set, the driver should return only contributions from the AGP heaps.

The driver indicates its support of DdGetAvailDriverMemory by implementing a response to GUID_MiscellaneousCallbacks in DdGetDriverInfo.

Requirements

Requirement Value
Target Platform Desktop
Header ddrawint.h (include Winddi.h)

See also

DD_GETAVAILDRIVERMEMORYDATA

DdGetDriverInfo