функция обратного вызова PDD_DESTROYDDLOCAL (ddrawint.h)
Функция D3dDeшитDDLocal уничтожает все поверхности Microsoft Direct3D, ранее созданные функцией D3dCreateSurfaceEx , которые принадлежат тому же заданному локальному объекту Microsoft DirectDraw.
Синтаксис
PDD_DESTROYDDLOCAL PddDestroyddlocal;
DWORD PddDestroyddlocal(
PDD_DESTROYDDLOCALDATA unnamedParam1
)
{...}
Параметры
unnamedParam1
Указывает на DDHAL_DESTROYDDLOCALDATA структуру, содержащую сведения, необходимые для того, чтобы драйвер уничтожил поверхности.
Возвращаемое значение
D3dDeкиоDDLocal возвращает один из следующих кодов обратного вызова:
Комментарии
Все драйверы Direct3D должны поддерживать D3dDeкистройDDLocal.
Direct3D вызывает D3dDeкистройDDLocal , когда приложение указывает, что контекст Direct3D больше не требуется и он будет уничтожен вместе со всеми связанными с ним поверхностями. Связь происходит через указатель на локальный объект DirectDraw. Драйвер должен освободить любую память, выделенную обратным вызовом D3dCreateSurfaceEx драйвера для каждой поверхности, если это необходимо.
Драйвер не должен уничтожать поверхности DirectDraw, связанные с этими поверхностями Direct3D. За это отвечает приложение.
Указатель на структуру DD_DIRECTDRAW_LOCAL , переданную в качестве члена lpDDLclструктуры D3DHAL_CONTEXTCREATEDATA при вызове D3dContextCreate , освобождается операционной системой после возврата D3dDetextDDLocal .
D3dDeкистройDDLocal можно вызвать с отключенным PDEV. PDEV отключается или включается путем вызова функции DrvAssertMode драйвера дисплея. Дополнительные сведения см. в разделе Управление PDEV .
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | ddrawint.h (включая Winddi.h) |