функция обратного вызова PDD_SURFCB_DESTROYSURFACE (ddrawint.h)

  • Статья

Функция обратного вызова DdDeземпляраSurface уничтожает поверхность DirectDraw.

Синтаксис

PDD_SURFCB_DESTROYSURFACE PddSurfcbDestroysurface;

DWORD PddSurfcbDestroysurface(
  PDD_DESTROYSURFACEDATA unnamedParam1
)
{...}

Параметры

unnamedParam1

Указывает на DD_DESTROYSURFACEDATA структуру, содержащую сведения, необходимые для уничтожения поверхности.

Возвращаемое значение

DdDefacesurface возвращает один из следующих кодов обратного вызова:

Комментарии

Если DirectDraw выделял память во время создания поверхности, а драйвер не принимал участия в выделении, DirectDraw не вызывает функцию DdDeкимSurface драйвера для уничтожения поверхности.

Если драйвер сам выполняет управление памятью surface, DdDeкистратьSurface должен освободить память Surface и выполнить любую другую очистку, например освобождение частных данных, хранящихся в членах dwReserved1DD_SURFACE_GLOBAL и DD_SURFACE_LOCAL структурах.

Для поверхности, управляемой драйвером, если surface является постоянной (то есть флаг DDSCAPS2_DONOTPERSIST в элементе dwCaps2 структуры DDSCAPS2 для поверхности не задан), DdDeземSurface можно вызвать с целью вытеснения поверхности из видеопамяти. В этом случае драйвер дисплея может продолжать хранить любые личные данные в членах dwReserved1 до тех пор, пока не будет вызван DdDeкимSurface для фактического уничтожения поверхности.

DdDefaceSurface можно вызвать с отключенным PDEV. PDEV отключается или включается путем вызова функции DrvAssertMode драйвера дисплея. Дополнительные сведения см. в разделе Управление PDEV .

Требования

   
Целевая платформа Персональный компьютер
Верхняя часть ddrawint.h (включая Winddi.h)

См. также раздел

DDSCAPS2

DD_DESTROYSURFACEDATA

DdCreateSurface