DD_FREE_DEFERRED_AGP_DATA structure (d3dhal.h)

DirectX 8.0 and later versions and NT-based operating systems only.

DD_FREE_DEFERRED_AGP_DATA is the data structure pointed to by the lpvData field of DD_GETDRIVERINFODATA for D3DGDI2_TYPE_DEFER_AGP_FREES and D3DGDI2_TYPE_FREE_DEFERRED_AGP notifications.

Syntax

typedef struct _DD_FREE_DEFERRED_AGP_DATA {
  DD_GETDRIVERINFO2DATA gdi2;
  DWORD                 dwProcessId;
} DD_FREE_DEFERRED_AGP_DATA;

Members

gdi2

Specifies a DD_GETDRIVERINFO2DATA structure that contains the GetDriverInfo2 data.

dwProcessId

Specifies the process identifier (PID) of the process destroying the AGP memory for surfaces.

Remarks

The driver sometimes receives a GetDriverInfo2 call with D3DGDI2_TYPE_DEFER_AGP_FREES notification type before a display mode change occurs. The runtime only sends this notification type if it is to be used to perform the display mode change. Drivers should check the process identifier (PID) of the process destroying the surface against the process that created the surface. If the PIDs are different, the driver probably should not destroy the user-mode mappings of the AGP memory because an application might still be using the memory.

The driver receives a GetDriverInfo2 call with D3DGDI2_TYPE_FREE_DEFERRED_AGP notification type when all display devices within the process stop using surfaces, textures, vertex buffers, and index buffers that were locked at the time of the display mode change. This notification type informs the driver that it is now safe to destroy all the user-mode mappings of the AGP memory.

Requirements

See also

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA