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

Статья
08/23/2023

Функция D3dDeшитDDLocal уничтожает все поверхности Microsoft Direct3D, ранее созданные функцией D3dCreateSurfaceEx , которые принадлежат тому же заданному локальному объекту Microsoft DirectDraw.

Синтаксис

PDD_DESTROYDDLOCAL PddDestroyddlocal;

DWORD PddDestroyddlocal(
  PDD_DESTROYDDLOCALDATA unnamedParam1
)
{...}

Параметры

unnamedParam1

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

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

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

Direct3D вызывает D3dDeкистройDDLocal , когда приложение указывает, что контекст Direct3D больше не требуется и он будет уничтожен вместе со всеми связанными с ним поверхностями. Связь происходит через указатель на локальный объект DirectDraw. Драйвер должен освободить любую память, выделенную обратным вызовом D3dCreateSurfaceEx драйвера для каждой поверхности, если это необходимо.

Драйвер не должен уничтожать поверхности DirectDraw, связанные с этими поверхностями Direct3D. За это отвечает приложение.

Указатель на структуру DD_DIRECTDRAW_LOCAL , переданную в качестве члена lpDDLclструктуры D3DHAL_CONTEXTCREATEDATA при вызове D3dContextCreate , освобождается операционной системой после возврата D3dDetextDDLocal .

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